4 ms·
In my dreams, you have docs and source code in the same repo, and update both in a single pull request. In reality, confluence...
by stopthe 2y ago
In my dreams, you have docs and source code in the same repo, and update both in a single pull request. In reality, confluence...
- mdaniel 2y agoMerely 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
- nicholasjarnold 2y agoI'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.