← Back to context

Comment by 4b11b4

21 days ago

This is fundamentally flawed. Code cannot always capture the requirements, nor the reasoning or scenario which led to these requirements.

Nevertheless, it captures what the system does. That makes it the true spec even if it's hard to read or figure out the intent behind. Writing an intent document is basically having a fap if the system doesn't do what you intend.

  • Well sure but the discussion isn't "is the code is correct".

    • Right it's whether your aspirations need to be grounded in reality.

      Do you actually need to build strong foundations, or can you just throw away all your work every time and start over from scratch?

      What confounds me is why I am on Hacker News having to defend the idea of software architecture being a kind of capital. That's not supposed to make some sort of countercultural revolutionary. Where did everyone go!!

      1 reply →