jupyter-book icon indicating copy to clipboard operation
jupyter-book copied to clipboard

Clarify the difference between Jupyter Book and the MyST engine and when to use each

Open choldgraf opened this issue 5 months ago • 1 comments

Our JB docs could make it easier to answer a few questions:

  • What's the relationship between jupyter book and mystmd at a technical level?
  • What user archetype is each meant for? When should you use one vs. the other?
  • What's the short-hand way for describing this relationship? (e.g. "Jupyter Book is a distribution of the MyST Engine" vs. "Jupyter Book is MyST")

Some easy-to-find guidance (perhaps on the ecosystem page, or the landing page) would help.

choldgraf avatar Jul 24 '25 16:07 choldgraf

It would also be useful to have some guidance to help decide whether an issue should be posted here or at mystmd (or somewhere else like the theme repos). (Does that already exist somewhere?)

zmoon avatar Oct 08 '25 14:10 zmoon