On avoiding saying "straightforward" or "just": https://www.cs.uni.edu/~wallingf/blog/archives/monthly/2017-08.html#e2017-08-11T09_08_53.htm (I find it's more welcoming to newbies to avoid these terms)
miniblog.
Related Posts
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.
TIL rustc has a style guide for suggestions! https://rustc-dev-guide.rust-lang.org/diagnostics.html#suggestion-style-guide
They recommend avoiding 'did you mean' or 'the following' in favour of direct suggestions and highlighted positions.
Contrasting the C++ committee with Rust's RFC process, and avoiding antagonistic design evaluation: