Minimal fix of intro for 2026

[mmesiti]

Fixes #328

• readthedocs.org -> ghpages
• mention personal/project page is optional
• plausible time table
• consistency between list of episodes and content of intro

Note: still independent of other PRs (most importantly: #325)

[bast]

This conflicts now but let me know if I can help resolving.

[samumantha]

Nice clarification!

[frankier]

LGTM -- but is it really "independent of programming languages"? At least the API docs are not. This seems more like a goal than the actual state of things. Maybe hedge with "mostly"?

For documentation tools, leaning into the language specific ones come with the benefit of ecosystem convention: less configuration/boilerplate and consistent experience browsing different library documentation.

[mmesiti]

LGTM -- but is it really "independent of programming languages"? At least the API docs are not. This seems more like a goal than the actual state of things. Maybe hedge with "mostly"?

I sympathize with this, but to be utterly precise, we claim that the demonstration is independent of programming languages. Which still is not, completely, because conf.py is written in python. So amending this.

For documentation tools, leaning into the language specific ones come with the benefit of ecosystem convention: less configuration/boilerplate and consistent experience browsing different library documentation.

One could argue that the sphinx exercise could be split into different tabs, one for each relevant programming language and tool. But - is there demand for that? Should we add pkgdown/doxygen/documenter.jl examples for the next workshop? Food for thought for another time.

[mmesiti]

fixed conflict, force pushed, addressing @frankier 's comment, hopefully. @frankier might merge if satisfied.

[samumantha]

One could argue that the sphinx exercise could be split into different tabs, one for each relevant programming language and tool. But - is there demand for that? Should we add pkgdown/doxygen/documenter.jl examples for the next workshop? Food for thought for another time.

• Yes please, any tool that others may use :) please add an issue!