[grepfru_it]

I'm old school, Visio was been the gold standard for so long that I still use it. Draw.io/Diagrams.net provides a good enough solution that that has been my goto lately.

I don't think there is any problem with too much detail, you can always "dumb it down" for your target audience. I regularly work on the super big detailed picture diagram and export relevant parts to other pages as the audience demands. If i'm in an engineering design meeting, we are looking at that big detail. If I am working with release team, then we probably are only looking at high level components. Likewise the DB team may want the detailed view of migrations. To get those smaller diagrams its just a bunch of command-clicking and copy/pasting to a new sheet!

Also as a side note, at least with Visio, you can throw some python at the file to read/write your own diagrams. While I never automated the detailing aspect, I have programmatically created visio rack diagrams from excel spreadsheets