Communities

Writing
Writing
Codidact Meta
Codidact Meta
The Great Outdoors
The Great Outdoors
Photography & Video
Photography & Video
Scientific Speculation
Scientific Speculation
Cooking
Cooking
Electrical Engineering
Electrical Engineering
Judaism
Judaism
Languages & Linguistics
Languages & Linguistics
Software Development
Software Development
Mathematics
Mathematics
Christianity
Christianity
Code Golf
Code Golf
Music
Music
Physics
Physics
Linux Systems
Linux Systems
Power Users
Power Users
Tabletop RPGs
Tabletop RPGs
Community Proposals
Community Proposals
tag:snake search within a tag
answers:0 unanswered questions
user:xxxx search by author id
score:0.5 posts with 0.5+ score
"snake oil" exact phrase
votes:4 posts with 4+ votes
created:<1w created < 1 week ago
post_type:xxxx type of post
Search help
Notifications
Mark all as read See all your notifications »
Q&A

Post History

75%
+4 −0
Q&A How do you track dependencies for your co-authors?

I've changed teams (and companies) since asking this question years ago, and the doc set is even larger on my current team. Here's how we manage changes that affect parts of the documentation with...

posted 4y ago by Monica Cellio‭

Answer
#1: Initial revision by user avatar Monica Cellio‭ · 2020-01-12T03:41:44Z (over 4 years ago)
I've changed teams (and companies) since asking this question years ago, and the doc set is even larger on my current team.  Here's how we manage changes that affect parts of the documentation with different primary/responsible writers.

First, we do use source control as mentioned in another answer.  At my insistence, we now do work on branches and merge to master only when work is complete.

Because we use branches, more than one writer can work on the same branch at the same time.  If my change has impact on someone else's area, we can both work on it together without making master inconsistent.

That said, we try to be flexible about boundaries.  If I *can* make (or propose) a change in someone else's area, I should do so and then ask the primary author to review it.  That's easier to coordinate than working together on the branch when we can't just sit down together.  (Yeah, my current team is geographically distributed, too.)

And when all else fails -- for example, when the other affected documentation is a blog post or a training module, neither of which is part of our doc repo -- then we file tickets in our bug-tracking system to make sure things don't get lost.  We tie all non-trivial work to tickets already, and can use dependencies in the ticketing system to tie tasks together.  Applying some discipline to tickets (it's not resolved until everything's on master) helps to prevent things from falling through the cracks.

We do have informal communication channels -- chat, email, team meetings, and the like.  These can be extremely helpful when I *mostly* understand what I need to do in someone else's area but have a few questions, for instance.  Sometimes the result is an explanation and sometimes the result is that the other writer does that part of the work.