GitHub READMEs work exceptionally well for projects which only need a single page of docs.
Transitioning to a hosted, multiple page documentation structure is hard though. I've dabbled with a few tools but not found a clear favourite yet.
Related Posts
I've been writing docs for different programming language operators (+, *, == and so on). Each one gets a separate web page.
I've suddenly realised that / is much harder! docs/+ and docs/== is fine, but docs// just doesn't work as a URL in a static site.
Any ideas?
WebAssembly seems like a totally reasonable bytecode format, but I've not had many opportunities to use it so far.
Has wasm found its 'killer app' yet?
I've dabbled with 'conventional commits' for a personal project but I found they slowed me down.
It's not always easy to categorise a commit as a fix, a chore etc. Sometimes refactorings also fix bugs.
Do you use them? I can imagine a large, mature project benefitting more.