Post by @dr_greg_landrum@mastodon.social

2026-02-16 17:29 UTC

@freedosproject@fosstodon.org @jemonat@fosstodon.org if there’s a way to do that while still maintaining the full notebook for humans who want a tutorial, I’m all for it Otherwise, the idea of having that tutorial be 15 separate docs is not especially appealing

Replies (3)

@dr_greg_landrum@mastodon.social 2026-02-16 17:31

@freedosproject@fosstodon.org @jemonat@fosstodon.org unless, of course someone can point to a study that shows that technical/scientific documentation is more effective when split into small pieces

Open ##2578052
@freedosproject@fosstodon.org 2026-02-17 04:47

@dr_greg_landrum@mastodon.social @jemonat@fosstodon.org DITA can do that, but that's kind of a big lift for a project like this. Another, simpler way is to break up the content into pages— but not complete HTML pages, just the content that would go into . Then you have a wrapper (PHP?) that displays them as individual pages … or another wrapper that includes everything at once.

Open ##2578055
@dr_greg_landrum@mastodon.social 2026-02-17 05:52

@freedosproject@fosstodon.org @jemonat@fosstodon.org I mis-spoke here: the getting started doc is one big RST file, not a notebook

Open ##2578057