CartoDB/cartoframes

Generate Guides from Jupyter Notebooks

elenatorro opened this issue · 0 comments

Current status: [WIP] Staging


Context

In order to avoid duplication and improve the release process, we aim to write the Guides as notebooks instead that using markdown format.

Main reasons:

  • Easily check if a guide is failing and why
  • Don't need to run and re-publish examples, because visualization and tables will be automatically embedded
  • Easier to modify and maintain

This issue has two parts:

  • Create a Jupyter Notebook from each guide
  • Generate guides from Jupyter Notebooks in the developer center (as we're doing with the examples)