• Carighan Maconar
    link
    fedilink
    36 months ago

    In long term development, sensible and updated documentation is far more important than the software working constantly. You will have downtimes. You will have times before the PoC is ready.

    But if your documentation sucks or is inexistent, you cannot fix any problems that arise and will commit a ton of debt the moment people change and knowledge leaves the company.

    • @Aurenkin@sh.itjust.works
      link
      fedilink
      -26 months ago

      Fair enough, at my job the code working consistently is absolutely the number one priority at all times but I can imagine that there are some places where this is not true. If working software isn’t imporant then I agree agile is probably not the right choice

      It’s worth pointing out though that having insufficient documentation is not a feature of agile. Sounds more like laziness or misplaced priorities to me as documentation is called out as being useful in the agile principles, just not as important as working software.

      • Carighan Maconar
        link
        fedilink
        26 months ago

        Definitely. Most often it’s people misunderstanding the “a over b” of agile as “never do b”.