



The article discusses the pitfalls of writing technical comparisons that alienate parts of the audience, using the example of comparing 'foo' and 'bar' where some readers might know 'bar' as 'frobnicated foo'. It warns that such comparisons can confuse and alienate readers who have different terminology or strong opinions about technical concepts, suggesting

newsletter.bphogan.com6mo ago
The article discusses the challenges of science communication and technical writing, emphasizing the importance of knowing your audience. It critiques how advice about audience awareness is often given without practical examples, and explores the gap between formal scientific lit
soatok.blog·Hacker News: Front Page·9mo ago·11 min readThe author expresses a strong preference for reStructuredText (rST) over Markdown, citing their experience using Sphinx for writing books like 'Logic for Programmers' and 'Learn TLA+'. The article highlights the benefits of rST in technical documentation and publishing, including
