←back to thread

Red Hat Technical Writing Style Guide

(stylepedia.net)
196 points jumpocelot | 1 comments | 10 Jul 25 15:01 UTC | HN request time: 0.28s | source
Show context
david422 ◴[10 Jul 25 18:07 UTC] No.44523818[source]▶
This seems like one of the perfect use cases for AI. Have the AI ingest the style guide, and then comment on your written work to point out where your work does not adhere to the style guide.
replies(5): >>44523919 #>>44523975 #>>44524050 #>>44524434 #>>44525933 #
kaycebasques ◴[10 Jul 25 18:16 UTC] No.44523919[source]▶
Lots of people have tried it. The problem is the sheer number of rules in a typical technical writing style guide. I continue to believe that a fine-tuned model is the way to go, and I made a lot of progress on that front, but I learned firsthand how labor-intensive feature engineering can be.

The most reliable non-fine-tuned method I have seen is to do many, many passes over the doc, instructing the LLM to focus on only one rule during each pass.

replies(2): >>44524065 #>>44525710 #
1. golergka ◴[10 Jul 25 18:32 UTC] No.44524065[source]▶
One agent and some hard code to extract doc diffs with relevant code, parallel agents for different rule groups, tool agent to look up existing patterns and related material in the codebase, consolidator agent to merge the comments and suggestions, that’s how I would do it, for the first version at least. All of them fine tuned, ideally.