miniblog.

← Back to all posts
Jun 25, 2022 at 23:37
Framing documentation work as creative solving of problems, not just writing up stuff made by other people:
How to avoid being a secretary for engineers
How to avoid being a secretary for engineers
If we just see our task as documenting solutions that engineers have solved, it removes the creativity and critical thinking dimension from tech comm. The creative dimension in tech comm comes into play as we identify and solve tech comm challenges, such as devising ways to simplify complexity or otherwise improve the user experience.

Related Posts

Dec 31, 2025 at 12:33
24
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.
Oct 30, 2024 at 00:10
It's incredibly hard to explain adversarial problems to users. I see gamers sincerely asking "why doesn't the publisher just fix the cheater problem?". This is exacerbated by the fact that sharing too many details of anticheat can make the problem worse.
Jan 30, 2023 at 00:34
Codeforces is a huge website with a wealth of well-defined programming problems: https://codeforces.com/help#q1 (Useful for program synthesis and other situations where you want a large problem set to play with.)
Help - Codeforces
Help - Codeforces
Codeforces. Programming competitions and contests, programming community