News for hackers. Stuff that matters.
Re:The Guide to Software Architecture Documentation by 29athrowaway on Sunday January 22, 2023 @07:39PM (#34484025)
If "how can I work in software without coding" was an article.
Re:The Guide to Software Architecture Documentation by justasitsounds on Monday January 23, 2023 @01:04AM (#34486000)
Coding is the tip of the 'working in software' iceberg. If you don't see value in being able to communicate the reasons behind the technical choices and trade-offs you've made, both within your own team and to other stakeholders then you'll quickly find that your coding time is quickly eaten up by people asking you to explain it.

If you value periods of deep focus or 'flow' then believe me, having concise, accurate documentation that explains why, how and what you are building pays off - if only to help you separate the planning from execution process in your own workflow. I don't think any moderately complex software can be written without some degree of planning - but maybe your experience differs

Re:The Guide to Software Architecture Documentation by 29athrowaway on Monday January 23, 2023 @02:03AM (#34486271)
Yet, if you consistently avoid coding and lose touch with the reality at the implementation level, your ability to analyze requirements will be compromised.

No plan survives contact with the enemy. And if you've never been in the trenches, your plans won't add much value.