Re:Show HN: Create diagrams of complex data flows in softwar...
by stopthe on Tuesday July 30, 2024 @06:53AM
(#41107830)
In my dreams, you have docs and source code in the same repo, and update both in a single pull request. In reality, confluence...
[ Parent
| on HN ]
Re:Show HN: Create diagrams of complex data flows in softwar...
by mdaniel on Tuesday July 30, 2024 @11:31AM
(#41110138)
Merely as a "for your consideration," if you already have a build pipeline, rendering the in-repo docs and pushing them into Confluence could be a middle ground between "corporate overlords" and the workflow that works best for you and your team
Re:Show HN: Create diagrams of complex data flows in softwar...
by nicholasjarnold on Tuesday July 30, 2024 @11:41AM
(#41110257)
I've lived this life first-hand, and it is refreshing after experiencing the vast open sea of half-assed Confluence sprawl, huge PDF design documents that aren't kept up to date with changing requirements, etc.
The other sibling comment regarding rendering documentation source to Confluence or <required external system> to keep the corp overlords happy is a great middle ground IMO.