News for hackers. Stuff that matters.
Re:Ask HN: Is there a better way to document complex softwar... by basdp on Sunday November 25, 2018 @11:14AM (#18527428)
Man, it seems like you totally lost connection with technology. There is no value in an architect who doesn’t code (none, if you think otherwise you’ve worked too long in enterprises that don’t deliver enough value to stay relevant the coming years). Just use whatever drawing tools you know and draw up your diagrams. Should never take you hours to draw them up. How complex are they? If they take you so long, you probably are documenting way too much or are using way too complex architectures.

I feel the solution to your problem is more in the application than the tools. Try moving towards architectures like micro services. KISS. Then use the time you’re freeing up to keep connected to your developers and write code.

Re:Ask HN: Is there a better way to document complex softwar... by ex_amazon_sde on Sunday November 25, 2018 @01:20PM (#18528003)
One thing I loved about Amazon was having no architects, visio, powerpoints, UML in any of the teams I worked in.

Each service is designed, documented, implemented, deployed, maintained and advertised to other teams by the same few engineers.

Most documentation and runbooks are just text in wikis. If your service cannot be documented without drawing 10 boxes and 20 arrows you should split it in smaller services.

Re:Ask HN: Is there a better way to document complex softwar... by basdp on Sunday November 25, 2018 @01:23PM (#18528031)
That's nice! Agile to the max!
Re:Ask HN: Is there a better way to document complex softwar... by ex_amazon_sde on Wednesday November 28, 2018 @06:09AM (#18550663)
not really
Re:Ask HN: Is there a better way to document complex softwar... by Kaveren on Sunday November 25, 2018 @12:28PM (#18527773)
> "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.

Re:Ask HN: Is there a better way to document complex softwar... by basdp on Sunday November 25, 2018 @01:23PM (#18528020)
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.

Re:Ask HN: Is there a better way to document complex softwar... by jimjimjim on Sunday November 25, 2018 @02:21PM (#18528407)
Shack - doesn't need an architect.

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 softwar... by basdp on Sunday November 25, 2018 @03:04PM (#18528707)
So you're calling (f.e.) Amazon a shack?
Re:Ask HN: Is there a better way to document complex softwar... by jimjimjim on Sunday November 25, 2018 @03:26PM (#18528823)
And the Burj Khalifa doesn't need an architect?

Sometimes the system doesn't need it sometimes it does. Not all software systems are the same.

I personally think the architect role is to look at the big picture first rather than trying to dictate the minutiae.

Re:Ask HN: Is there a better way to document complex softwar... by basdp on Monday November 26, 2018 @08:02AM (#18533006)
The point is that an architect who doesn't 'code' (read: doesn't know how the practical implementation is done) doesn't know what he is designing. It's too abstract.

A structural architect is called the same, but is not really comparable. Apples and oranges. At the least because the Burj Khalifa is still built under the same physics model as they used 100 years ago.

Re:Ask HN: Is there a better way to document complex softwar... by adaml_623 on Wednesday November 28, 2018 @03:25AM (#18550030)
A shanty town?
Re:Ask HN: Is there a better way to document complex softwar... by bdittmer on Sunday November 25, 2018 @01:32PM (#18528091)
“Try moving towards architectures like micro services. KISS.”

I don’t think you have worked with micro services, or more importantly have had to manage them.

Re:Ask HN: Is there a better way to document complex softwar... by basdp on Sunday November 25, 2018 @03:05PM (#18528709)
All the time.
Re:Ask HN: Is there a better way to document complex softwar... by mden on Sunday November 25, 2018 @06:25PM (#18529750)
My initial impression is the same as the parent. Juxtaposing microservices and KISS seems weird as the "architectural complexity" of microservices is several times higher than a monolith. You're not only multiplying the points of failure but also increasing the difficulty of translating the domain into code, especially when it comes to reading and writing from a db in a safe and efficient manner. Someone will need to come up with an answer to handling transactional operations that span multiple services sooner or later (or I guess the team can just accept some small percent of data corruption, which is what I'm guessing most companies that do microservices actually do, willingly or unwillingly). Ironically I think the benefit of an architect is a lot more evident in a microservice architecture than a monolith.

Edit: though maybe my view on what an architect should do is different? I think of a software architect as the person that lays out the skeleton and foundations of a project and has the answers to hard questions. Very likely someone who actively codes or has solved very similar challenges to the ones being solved.

Re:Ask HN: Is there a better way to document complex softwar... by basdp on Monday November 26, 2018 @07:58AM (#18532977)
The problem with this approach is that it might be easier to build a monolith, maintaining it and the ops side of it is far more complex.
Re:Ask HN: Is there a better way to document complex softwar... by whydoineedthis on Sunday November 25, 2018 @11:45AM (#18527549)
Nice answer! No one else is trying to help this guy turn his life around, they are just answer in his question like sheep. /S
Re:Ask HN: Is there a better way to document complex softwar... by basdp on Sunday November 25, 2018 @01:25PM (#18528042)
Sometimes the answer to the wrong question helps you further down the wrong path.