miniblog.

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?

I like that most LLM UIs show your previous queries prominently. When figuring out where LLMs are useful in your workflow, it's nice to see what worked well (or not) in the past. Web search doesn't have this property. I rarely look at what I've previously googled.

There are docs resources like https://diataxis.fr/ that categorise documents based on format and intended audience. They don't say where you should start, or what order you should write docs. I'm currently thinking README > reference > tutorial > how-tos. Agree/disagree?