@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 (2)
-
@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
-
@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.