Files
dlt/docs/education
anuunchin 266052eb76 Docs: Converting Jupyter notebooks in education to marimo notebooks (#3068)
* Initial commit

* lesson_1_quick_start adjusted for marimo

* lesson_2_dlt_sources_and_resources_create_first_dlt_pipeline marimo

* Fundamentals course 3 improved

* Marimo badges added

* Fundamenta: course 8

* Marimo badge link fix

* Fundamentals: course 7

* Fundamentals: course 6

* Fundamentals: course 5

* Fundamentals: cousre 4

* Fundamentals: course 3

* Fundamentals: course 2

* Fundmantals: course 1

* marimo links corrected

* Inline deps

* Fundamentals: fix lesson 2

* Fundamentals: fix lesson 3

* Fundamentals: fix lesson 4

* Formatting moved to build-molabs

* Fundamentals: fix lesson 5

* Removal of scrolls

* Fundamentals: fix lesson 6

* Fundamentals: fix lesson 7

* Fundamentals: fix lesson 8

* os.environ replaced with dlt.secrets where relevant

* Advanced: fix lesson 5

* Advanced fix lesson 9

* os.environ fixes

* Advanced: fix lesson 1

* Comments cleanup

* Additional comment removal, fix lesson 6 advanced

* Clean main makefile

* Get rid of constants.py

* Nicer json.loads()

* Better functions in preprocess_to_molab

* Tests for doc tooling funcs

* Validate molab command

* Marimo check added

* docs pages adjustment

* limits sqlglot in dev group until fixed

---------

Co-authored-by: Marcin Rudolf <rudolfix@rudolfix.org>
2025-12-16 16:30:32 +01:00
..

Adding New Notebooks

Overview

The .py files in this directory are auto-generated from .ipynb files. Only edit the .ipynb files.

To regenerate .py files:

make build-molabs

Preprocessing logic: docs/docs_tools/education/

Things to consider

To ensure compatibility with both Google Colab and Marimo/Molab:

1. No inline comments

Bad: x = 5 # comment
Good: Separate line comments

Why: marimo convert scatters inline comments

Workflow

  1. Create/edit .ipynb in the course folder
  2. Follow guidelines above
  3. Run make build-molabs to generate .py files
  4. Test both versions (Colab and Molab)
  5. Commit both .ipynb and .py files
  6. Make changes to the processing logic in docs/docs_tools/education/ if necessary.