update conf.py, kernelspec config

Signed-off-by: Niels Bantilan <[email protected]>
flyteorg · Feb 5, 2024 · e4a9fac · e4a9fac
1 parent 8e3721b
commit e4a9fac
Show file tree

Hide file tree

Showing 9 changed files with 61 additions and 1 deletion.
diff --git a/docs/conf.py b/docs/conf.py
@@ -94,7 +94,7 @@
 
 
 autosummary_generate = True
-suppress_warnings = ["autosectionlabel.*"]
+suppress_warnings = ["autosectionlabel.*", "myst.header"]
 autodoc_typehints = "description"
 
 # The master toctree document.
@@ -294,6 +294,9 @@
     "flytesnacks/**/*",
     "examples/**/*",
 ]
+nb_custom_formats = {
+    ".md": ["jupytext.reads", {"fmt": "md:myst"}],
+}
 
 # Pattern for removing intersphinx references from source files.
 # This should handle cases like:
@@ -447,6 +450,7 @@ def filter(self, record: logging.LogRecord) -> bool:
             "Definition list ends without a blank line",
             "autodoc: failed to import module 'awssagemaker' from module 'flytekitplugins'",
             "Enumerated list ends without a blank line",
+            'Unknown directive type "toc".',  # need to fix flytesnacks/contribute.md
         )
 
         if msg.strip().startswith(filter_out):

diff --git a/docs/introduction/core_use_cases/analytics.md b/docs/introduction/core_use_cases/analytics.md
@@ -1,3 +1,10 @@
+---
+kernelspec:
+  display_name: Python 3
+  language: python
+  name: python3
+---
+
 (getting_started_analytics)=
 
 # Analytics

diff --git a/docs/introduction/core_use_cases/data_engineering.md b/docs/introduction/core_use_cases/data_engineering.md
@@ -1,3 +1,10 @@
+---
+kernelspec:
+  display_name: Python 3
+  language: python
+  name: python3
+---
+
 (getting_started_data_engineering)=
 
 # Data Engineering

diff --git a/docs/introduction/core_use_cases/machine_learning.md b/docs/introduction/core_use_cases/machine_learning.md
@@ -1,3 +1,10 @@
+---
+kernelspec:
+  display_name: Python 3
+  language: python
+  name: python3
+---
+
 (getting_started_machine_learning)=
 
 # Machine Learning

diff --git a/docs/introduction/flyte_fundamentals/extending_flyte.md b/docs/introduction/flyte_fundamentals/extending_flyte.md
@@ -1,3 +1,10 @@
+---
+kernelspec:
+  display_name: Python 3
+  language: python
+  name: python3
+---
+
 (getting_started_extending_flyte)=
 
 # Extending Flyte

diff --git a/docs/introduction/flyte_fundamentals/optimizing_tasks.md b/docs/introduction/flyte_fundamentals/optimizing_tasks.md
@@ -1,3 +1,10 @@
+---
+kernelspec:
+  display_name: Python 3
+  language: python
+  name: python3
+---
+
 (getting_started_optimizing_tasks)=
 
 # Optimizing Tasks

diff --git a/docs/introduction/flyte_fundamentals/run_schedule.md b/docs/introduction/flyte_fundamentals/run_schedule.md
@@ -1,3 +1,10 @@
+---
+kernelspec:
+  display_name: Python 3
+  language: python
+  name: python3
+---
+
 (getting_started_run_and_schedule)=
 
 # Running and Scheduling Workflows

diff --git a/docs/introduction/flyte_fundamentals/tasks_and_workflows.md b/docs/introduction/flyte_fundamentals/tasks_and_workflows.md
@@ -1,3 +1,10 @@
+---
+kernelspec:
+  display_name: Python 3
+  language: python
+  name: python3
+---
+
 (getting_started_tasks_and_workflows)=
 
 # Tasks, Workflows and LaunchPlans

diff --git a/docs/introduction/flyte_fundamentals/visualizing_task_input_and_output.md b/docs/introduction/flyte_fundamentals/visualizing_task_input_and_output.md
@@ -1,3 +1,10 @@
+---
+kernelspec:
+  display_name: Python 3
+  language: python
+  name: python3
+---
+
 (getting_started_visualizing_task_input_and_output)=
 
 # Visualizing task input and output