Remix.run Logo
throwaw12 6 hours ago

I will share my experience, hopefully it answers some questions to tech writers.

I was terrible writer, but we had to write good docs and make it easy for our customers to integrate with our products. So, I prepared the context to our tech writers and they have created nice documentation pages.

The cycle was (reasonably takes 1 week, depending on tech writer workload):

    1. prepare context
    2. create ticket to tech writers, wait until they respond
    3. discuss messaging over the call
    4. couple days later I get first draft
    5. iterate on draft, then finally publish it
Today its different:

    1. I prepare all the context and style guide, then feed them into LLM.
    1.1. context is extracted directly from code by coding agents 
    2. I proofread it and 97% of cases accept it, because it follows the style guide and mostly transforms my context correctly into customer consumable content
    3. Done. less than 20 minutes
Tech writers were doing amazing job of course, but I can get 90-95% quality in 1% of the time spend for that work.
arionmiles 6 hours ago | parent | next [-]

If you're getting such value out of LLMs, I'm intrigued to learn more about what exactly it is that you're feeding them.

People boast about the gains with LLMs all the damn time and I'm sceptical of it all unless I see their inputs.

anonymous_sorry 4 hours ago | parent | prev [-]

Your docs are probably read many more times than they are written. It might be cheaper and quicker to produce them at 90% quality, but surely the important metric is how much time it saves or costs your readers?