4 ms·
Technical Writing Style Guide
- feydaykyn 23d agoIf only Claude could read and apply theses guidelines!
- orbital-decay 23d agoHave you... tried giving it to Claude? Although a model would likely need a different guide, aimed at its particular issues.
- feydaykyn 22d agoHave you... tried having Claude be concise and easy to read (for more 2 sentences) ? If not, when you'll arrive at the despair state, search for "claudism"^^
- orbital-decay 22d agoYes, I've been doing this since Claude 2 (1.x really).
- feydaykyn 21d agoDo you have resources and examples to share? More than the previous versions, Sonnet/Opus 5 are very resistant to being concise.
- soltanov 22d ago[dead]
- jklowden 22d agoEvery technical writing guide I’ve found is depressing or boring. This one is both. I suppose we shouldn’t be surprised to see 8th-grade advice offered to adult professionals with a straight face. Nor finger-wagging about the passive. Honestly, you want the world to know “the president was elected by the voters” is improved by “the voters elected the president”? Want to be an excellent technical writer? Start by reading everything Brian Kernighan has written. Emulate. Repeat until done. Expect it to take time. Definitely years. Instead of worrying over Oxford commas, wonderful though they be, great technical writing starts with and keeps always the reader in mind. Not so different from all great writing, in fact. Drop the “X was designed to intended to” throat-clearing, and get to what the user can do with what X does. And thanks for taking the time.