How GitHub uses GitHub to document GitHub


Everyone knows that GitHub is the place to host your project's code. What you may not know is that the same workflow developers use to create, update, and manage their software is also used to create, update, and manage GitHub's documentation. is GitHub's second-most viewed site--after the main website itself. I'd like to provide a somewhat opinionated look on how our valiant Documentation team writes and releases content for features on and GitHub Enterprise. I'll go over:

  • How our teams (Development, Security, Docs, etc) coordinate before launching a feature
  • The importance of opening pull requests early
  • The review/edit cycle with peers
  • How we incorporate DITA best practices into our Markdown documentation
  • Validating content through CI and automated tests
  • How we incorporate feedback from our users
  • Conference: Write the Docs NA
  • Year: 2015

About the speaker

Garen Torikian