4 ms·
Don't fall into the trap of the new SEO for AIs. LLM are just like users. https://passo.uno/writing-for-llms-ai-chatbots/ https://passo.uno/writing-for-llms-ai-
by theletterf 1y ago
Don't fall into the trap of the new SEO for AIs. LLM are just like users. https://passo.uno/writing-for-llms-ai-chatbots/ https://passo.uno/writing-for-llms-ai-chatbots/
- steveklabnik 1y agoMost of the things described in this document are also good for humans. The justification is different, but the result is the same.
- pixl97 1y agoOr as I like to say, if current AI cannot explain your documentation well, then it's very likely humans can't either, your documentation sucks.
- Cthulhu_ 1y agoI'd even argue AI can comprehend stuff better than the average human can, so if an AI can just about comprehend your documentation, it should be made even simpler for humans.
- throwaway290 1y agoIf that was true people wouldn't title their articles "writing documentation for AI".
- steveklabnik 1y agoThat’s just SEO for humans ;) Would you care to make an actual argument about why these things aren’t good for humans too?
- throwaway290 1y agoBecause they encourage the newest way for .1% to rip off and monetize us. Write for humans not bots!
- steveklabnik 1y agoThat isn't addressing my claim: what about "use semantic HTML," "provide text equivalents for visuals," or "keep layouts simple," for example, makes docs worse for humans?
- throwaway290 1y agoIt's a problem because it's coincidentally good now. Like saying "let's not do crime to please our supreme leader". No crime is better for people but what if tomorrow pleasing supreme leader will mean something else but we are already so accustomed to do things to please supreme leader, hey they used to be good for us before right?