miniblog.

I've realised that AGENTS.md / CLAUDE.md solve two distinct problems: * It tells the LLM the conventions of the project, avoiding follow-up prompts. * It precomputes a summary of the project, saving a bunch of searches at the start of a session.

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?

Coming from JS or Python, imports in Rust feel weird. They're entirely optional aliases for fully qualified symbols, which are always available. I don't know of many other languages where you can just start using libraries. Java is the only one I can think of.