miniblog.

I see people advocating for writing a FAQ, but I really struggle to write one from scratch. The best FAQs are written as a response to, well, frequent questions. How do you populate the initial FAQ?

My default assumption is that external libraries are better than what I (or an LLM) would write in a v1. The extra effort to publish a project generally signifies that the author has spent a good amount of time on the problem. I end up prompting LLMs to prefer external code.

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?