news.ycombinator.com• 4d ago• 1 min read
I write my own MarkdownIn the context of side projects, I've come to these rules for code and text:1a) Code gets minimal review so long as I've architected the solution, built around the correct data structures (I've heard the code writes itself if the data structure is correct), and have specified the shape of the tests.1b) Tests I review to check for overfitting, cheats, etc.2) Comments in code can be chock-full of LLM-isms. Don't care.3) But the Markdown files, which may be read by a person or an LLM, those must be heavily redacted, edited, and put into a human voice.The simple reason is that LLM's, machines built to generate text, are incapable of presenting a linear flow of relevant facts without sidebars, tangents, irrelevancies, duplication, gaps, well-known style fails like overuse of stock words and phrases, layers of historical cruft, over-explanations, and qualitative fluff. In other words, they can't tell it straight.I have only one audience, people. Some of them read the text themselves, others
