recently I gave AI a task to configure a software and the software didn’t have any docs of how it works only the source code. the agent went through all the files and generated a summary of how it works and why it’s not working for my particular scenario and suggested edits to my docker-compose.yml file. I couldn’t believe it since the bug was very hard to find and it used headless firefox to find why it wasn’t working.

made me realize do we still need documentation of how a software work when a AI can easily explain it?

  • spartanatreyu@programming.dev
    1·
    5 hours ago

    There’s not really any such thing as a one off web page.

    Of course there is. What an absurd thing to say. A very obvious example is event websites, e.g. for weddings.

    Why would you not reuse event pages for the next event?

    Maybe it depends on the language but I’ve recently vibe coded two tools in Rust and I’ve skimmed the code and it’s perfectly good Rust. I would accept it in a PR - even if I was being as picky as I’d really like to be in reviews. I don’t think that would have been the case 3 months ago though.

    I’d expect that the code would be almost exactly the same as other code that already exists, in which case, why not use that code?