• AwkwardLookMonkeyPuppet
    link
    English
    76 months ago

    If documentation is the root cause of that then you should fix that by creating enough documentation to allow your software to continue to work

    Or create a better UI that doesn’t require so much documentation.

    • @pivot_root
      link
      12
      edit-2
      6 months ago

      This assumes front-end development.

      From a (dev)ops perspective, if I had a vendor hand me a tarball instead of proper documentation, I’d look very far away from their company. It isn’t a matter of if shit goes wrong, but when. And when that shit goes wrong, having comprehensive documentation about the architecture and configuration is going to be a lot more useful than having to piece it together yourself in the middle of an outage.

      • AwkwardLookMonkeyPuppet
        link
        English
        5
        edit-2
        6 months ago

        Yeah, I almost added a clarification for that very point, and see now that I should have.