, 4 tweets, 1 min read Read on Twitter
So we started running an experiment on my team a couple of months ago where design docs are checked into a repo and reviewed as a PR instead of done in a word doc and stored on a sharepoint or wiki. This was inspired by @github process, and I have to say I love it.
Its really easy to see what comments were made and track that they are addressed, and which docs are a work in progress vs approved. If its in master it is approved, otherwise still in progress.
Its the same tool chain developers use all day to write and review code, so writing and reviewing docs doesn't feel like a huge context switch.
And now its super easy to update and track the history of the doc over time. If a new person finds the doc has diverged from what we actually have when ramping up, they can just submit a PR.
Missing some Tweet in this thread?
You can try to force a refresh.

Like this thread? Get email updates or save it to PDF!

Subscribe to Caitie McCaffrey
Profile picture

Get real-time email alerts when new unrolls are available from this author!

This content may be removed anytime!

Twitter may remove this content at anytime, convert it as a PDF, save and print for later use!

Try unrolling a thread yourself!

how to unroll video

1) Follow Thread Reader App on Twitter so you can easily mention us!

2) Go to a Twitter thread (series of Tweets by the same owner) and mention us with a keyword "unroll" @threadreaderapp unroll

You can practice here first or read more on our help page!

Follow Us on Twitter!

Did Thread Reader help you today?

Support us! We are indie developers!


This site is made by just three indie developers on a laptop doing marketing, support and development! Read more about the story.

Become a Premium Member ($3.00/month or $30.00/year) and get exclusive features!

Become Premium

Too expensive? Make a small donation by buying us coffee ($5) or help with server cost ($10)

Donate via Paypal Become our Patreon

Thank you for your support!