News for hackers. Stuff that matters.
Re:Ask HN: Is there a better way to document complex softwar... by thedevindevops on Thursday November 22, 2018 @10:41AM (#18510593)
>where is the modern 'IDE' for the Software Architect

It's the same one the software developers use, 'architects' don't stop coding, the system architecture doesn't exist in Visio or PP. It's evident from the structure of the codebase and the accompanying documentation, your role is to collaborate and work with the senior devs to ensure this design vision is realised and to explain in documentation why this architecture solves the business requirement it pertains to.

It's not something you wash your hands of and walk away from, having handed it over to the dev team. You're in it for the long haul, same as them.

Re:Ask HN: Is there a better way to document complex softwar... by gaius on Sunday November 25, 2018 @01:33PM (#18528095)
It's not something you wash your hands of and walk away from, having handed it over to the dev team

Unfortunately that is the reality of the vast majority of Enterprise Architects I have ever worked with, writing massive tomes completely disconnected from the actual systems. The could all be fired tomorrow and no one would even notice (in fact one company I worked for did exactly that after too many complaints about them from the devs! And since they sat in their own cordoned off section, really no one did notice until the meeting invites suddenly stopped!).

The only architecture that matters is a living document; for example the CloudFormation or Terraform that actually generates it for real.

Re:Ask HN: Is there a better way to document complex softwar... by TylerJewell on Sunday November 25, 2018 @12:10PM (#18527686)
The Ballerina programming language (ballerina.io) has a syntax designed in such a way that any syntactically correct program can have its sequence diagram generated automatically. It's a type of self-documenting programming language. It only documents for the scope of the service that is being programmed, but eventually if many components and services are programmed with Ballerina, system wide architecture diagrams can also be constructed.
Re:Ask HN: Is there a better way to document complex softwar... by mattdeboard on Sunday November 25, 2018 @05:36PM (#18529515)
This is interesting. I ctrl-f'd for "self-doc" because I was wondering when we will start seeing Terraform, Puppet, etc., have options to generate a diagram automatically as part of their normal operation. Self-documenting infrastructure would be a godsend. My organization is challenged by the lack of documentation of our infrastructure, especially.

edit: Most of the responses to the original post seem to be addressing the idea of understanding code through diagramming. I am _much_ more interested in understanding complex infrastructure through diagrams. What queues do we have, what are the producers, what are the consumers? Where is the database? What writes to it? What do we shard on?

Code's a lot slipperier to autodoc, and the slipperiness is a function of number of contributors.

Infrastructure, however, we have been herding (pun intended) to a more declarative, predictable paradigm for years which is great. So let's start building the auto-documentation stuff into e.g. Terraform, since infrastructure-as-code seems like the natural place for such useful side effects of provisioning assets.

Re:Ask HN: Is there a better way to document complex softwar... by sien on Sunday November 25, 2018 @06:31PM (#18529775)
It's already there with Terraform but it's not that pretty yet:

https://www.terraform.io/docs/commands/graph.html

Re:Ask HN: Is there a better way to document complex softwar... by qznc on Monday November 26, 2018 @03:32PM (#18536537)
More evidence that graphviz needs a successor or makeover. Some force-based post-processing with the additional goal of rectangular borders would be good. Also some tweaks like little arcs where lines cross and shadows for boxes.
Re:Ask HN: Is there a better way to document complex softwar... by quickthrower2 on Sunday November 25, 2018 @02:49PM (#18528615)
I wonder if this needs its own language. It looks like c# from a quick glance. I wonder if static analysis on an existing language would be just as good. In any case I love this idea.
Re:Ask HN: Is there a better way to document complex softwar... by pmontra on Sunday November 25, 2018 @12:07PM (#18527673)
If the project is very large architects don't have time to code. Sometimes they can test something before taking decisions but all the production code is written by somebody else. Their role is more about meeting people and help the organization making the correct decisions.
Re:Ask HN: Is there a better way to document complex softwar... by maxxxxx on Sunday November 25, 2018 @01:37PM (#18528112)
I am always wary of architects that don't code or at least aren't involved in the whole life time of the project so they have to feel the consequences of their designs. Our IT department is full of "architects" whose designs then get outsourced to India. Either their designs are crap that doesn't survive the first contact with reality or they are so trivial that pretty much anybody could do them. They spend a lot of time in meetings with important people though.

I find it much better to empower the senior devs of different teams to duke it out among them. Maybe the process is not as clean as having some genius architect divine the perfect architecture but it reflects reality much better.

Re:Ask HN: Is there a better way to document complex softwar... by AlphaWeaver on Sunday November 25, 2018 @12:28PM (#18527775)
I think this depends... I work at a Fortune 100 company, and I know architects that still code, despite being involved with large projects...
Re:Ask HN: Is there a better way to document complex softwar... by fsloth on Sunday November 25, 2018 @12:23PM (#18527754)
What is "very large"?
Re:Ask HN: Is there a better way to document complex softwar... by pmontra on Sunday November 25, 2018 @01:29PM (#18528074)
In my experience, a multi country mobile operator bootstrapping when 3G was a new thing 15+ years ago.
Re:Ask HN: Is there a better way to document complex softwar... by unixhero on Sunday November 25, 2018 @01:17PM (#18527991)
1 billion dollar 5 year multi project it transformations
Re:Ask HN: Is there a better way to document complex softwar... by PeterisP on Sunday November 25, 2018 @01:08PM (#18527943)
Hundreds of full time developers?