4 ms·

> It's long been the case that the best way to learn something is to teach something Which is pretty unfortunate for those that want to learn. I used to enjoy

> It's long been the case that the best way to learn something is to teach something Which is pretty unfortunate for those that want to learn. I used to enjoy writing documentation at work, it was my favorite part of the job. And it did feel like it benefited me more than it benefited all the people that were (or weren't) reading my documentation. Now I can't really justify spending much time on docmentation when LLM's can do it in a fraction of the time and it's "good enough"

intrasight 1mo ago
I got started as a software engineer working in the nuclear industry in the 80s. We measured our documentation in inches not pages, and it was all written by hand. And I'll bet you the documentation in the nuclear industry is still written by hand and not by LLMs.
- champagnepapi 1mo ago
  I sure hope those docs aren’t written by LLMs for many reasons!
  - andrekandre 1mo ago
    i wonder if people who use llm's for business critical documentation would have the same opinion, and if so why?
    - piloto_ciego 1mo ago
      I have used LLMs for safety sensitive tech writing and so have people I know. It’s pretty good at it, and you usually have a 95% ready to go product at the end of it. The last 5% can pretty easily be filled in by technical experts with way less time spent battling the type writer. Is it perfect? No. But it suffices most of the time in a pinch. Can’t speak to the nuke industry, but it’s pretty good at aviation related things.
      - intrasight 1mo ago
        A good compromise would be to have the LLM write the outline. That also helps get over the activation energy of starting. Then elaborate in small chunks so the human domain expert can remain focused during review.
        piloto_ciego 1mo ago
        You don’t even really need to do that… You tell it what you need, and it pretty much does all the work: > please give me a 135 compliant maintenance manual, use the attached document as a primer, reference every part 135, 91, 43, and 65 reg as appropriate as well as the other included manuals. Make sure to reference every requirement in the attached list of requirements. Aircraft mx manuals are in the folder “mx-manuals” and our current forms are pdfs in the “forms” folder. Remember our operation is <describe scope of operation here>, not a major airline. Have fun! This does surprisingly well and meets requirements at about 95% or better accuracy. Typically the only problem I routinely is trying to make the manual like a Delta Air Lines manual instead of one for a small air taxi.
unethical_ban 1mo ago
There is still value in experts distilling knowledge and crafting it to the audience. I'm a consultant in cybersecurity and someone asked me "give me a best practice framework for good policy hygiene". I'm sure an LLM could spit out some tips, but I've been on the industry 15 years and can write in 5 pages what an LLM wouldn't conceive of in that space.

intrasight 1mo ago

I got started as a software engineer working in the nuclear industry in the 80s. We measured our documentation in inches not pages, and it was all written by hand. And I'll bet you the documentation in the nuclear industry is still written by hand and not by LLMs.

champagnepapi 1mo ago
I sure hope those docs aren’t written by LLMs for many reasons!
- andrekandre 1mo ago
  i wonder if people who use llm's for business critical documentation would have the same opinion, and if so why?
  - piloto_ciego 1mo ago
    I have used LLMs for safety sensitive tech writing and so have people I know. It’s pretty good at it, and you usually have a 95% ready to go product at the end of it. The last 5% can pretty easily be filled in by technical experts with way less time spent battling the type writer. Is it perfect? No. But it suffices most of the time in a pinch. Can’t speak to the nuke industry, but it’s pretty good at aviation related things.
    - intrasight 1mo ago
      A good compromise would be to have the LLM write the outline. That also helps get over the activation energy of starting. Then elaborate in small chunks so the human domain expert can remain focused during review.
      - piloto_ciego 1mo ago
        You don’t even really need to do that… You tell it what you need, and it pretty much does all the work: > please give me a 135 compliant maintenance manual, use the attached document as a primer, reference every part 135, 91, 43, and 65 reg as appropriate as well as the other included manuals. Make sure to reference every requirement in the attached list of requirements. Aircraft mx manuals are in the folder “mx-manuals” and our current forms are pdfs in the “forms” folder. Remember our operation is <describe scope of operation here>, not a major airline. Have fun! This does surprisingly well and meets requirements at about 95% or better accuracy. Typically the only problem I routinely is trying to make the manual like a Delta Air Lines manual instead of one for a small air taxi.

unethical_ban 1mo ago

There is still value in experts distilling knowledge and crafting it to the audience. I'm a consultant in cybersecurity and someone asked me "give me a best practice framework for good policy hygiene". I'm sure an LLM could spit out some tips, but I've been on the industry 15 years and can write in 5 pages what an LLM wouldn't conceive of in that space.