I never knew architect was a thing in software.
The title is commonly found in heterogeneous projects where software isn't the solo driver. Ex: embedded systems Pretty much the title just describes a senior dev., who owns the software aspect of the project.
Ask HN: Is there a better way to document complex software architectures?
101–110 of 239 posts
Re: Ask HN: Is there a better way to document complex software architectures?
#102Dia/visio for general diagrams and ArgoUML/plantUML for sequence diagrams. I found that the only useful UML diagram is the sequence diagram, that really needs a dedicated tool to draw. PlantUML has simple text markup to describe diagram. It's easier than drawing and it can be integrated in documentation and generated on the fly (sphinx, wiki, doxygen). And last but not least, ascii diagrams with http://asciiflow.com/…
Certain email viewers like to ... "re-format" even fixed-width plain text and thus mis-render even ASCII art (looking at you, Outlook). Of course, every time I've received such reports, I've been able to brush the problem aside by simply asking people to use a different email viewer, or view the docs in a browser proper.
Re: Ask HN: Is there a better way to document complex software architectures?
#103Earlier quoted context omitted.
> "There is no value in an architect who doesn’t code" This is debatable. The OP almost certainly knows how to code, and I think you can still provide quite a lot of value even if all you do is architecture. It's much like saying a building's architect is worthless if they're not also doing construction work. I don't buy it.
Buildings are still built using stones, wood, cement. That doesn't change much. In my experience as a DevOps transformation expert, 'Architects' are mostly old devs that have been kicked upstairs. The whole world changes each year to an extreme. You have to get your feet wet.
House - some do, some don't.
Commercial Building - yep.
Factory, Bridge or Infrastructure - you're insane if you don't.
Just like in construction, it depends on what you are building/expanding. Not all software is the same.
Re: Ask HN: Is there a better way to document complex software architectures?
#104Quick question that I only ask because of my 30-odd year history as a corporate contractor... Does anyone here really use those UML-based docs to actually learn the systems? Or do they do what I always did and use the trusty step-debugger for a few days and come up with your own mental model of them? Inevitably, unless someone is working full time on them, they are incomplete and several months out-of-date, and that…
A well done diagram would have an as of date, and some commentary along side boxes.
Re: Ask HN: Is there a better way to document complex software architectures?
#105Re: Ask HN: Is there a better way to document complex software architectures?
#106If you need documentation for architecture, your architecture is complicated. Improve the architecture instead.
Sometimes the least complicated architecture is still complicated (by human standards).
Re: Ask HN: Is there a better way to document complex software architectures?
#107The Art of Visualising Software Architecture by Simon Brown is an interesting presentation on this topic: https://www.youtube.com/watch?v=zcmU-OE452k He references this other talk by Adam Tornhill on a similar topic: https://www.youtube.com/watch?v=XzsXvsHcjc0
Re: Ask HN: Is there a better way to document complex software architectures?
#108Quick question that I only ask because of my 30-odd year history as a corporate contractor... Does anyone here really use those UML-based docs to actually learn the systems? Or do they do what I always did and use the trusty step-debugger for a few days and come up with your own mental model of them? Inevitably, unless someone is working full time on them, they are incomplete and several months out-of-date, and that…
It's pretty straightforward - if it's pdf it's not versioned. If it's not versioned it's a fossil. The only thing I've ever done to reason about a new system is read the tests.
Re: Ask HN: Is there a better way to document complex software architectures?
#109Full disclosure: I am one of the developers of a product which does the below, also known as model driven architecture. For about 5 years now, the teams I have been on have found great success in the use of DDD. Towards this we have used a tool which not only allows us to visually model the domain using UML, but also performs what we call “code management” (smarter code-gen which doesn’t get in your way, or produce u…
I appreciate your reply and that it didn't end with "So, you should use program X (the one you work on) because it's the best software". Your objective response is great.
Re: Ask HN: Is there a better way to document complex software architectures?
#110I use BPMN 2.0 with DMN
Look it up, see what you think.