DEV Community

loading...

Write the Docs PodcastWrite the Docs Podcast

WTD Episode 22: Managing multiple doc projects across Git repositories, with Giles Gaskell

Write the Docs Podcast Play Button Pause Button
play

In episode 22, Giles Gaskell from Squiz in Australia joins us to talk about managing multiple doc projects across Git repositories through Antora. Giles explains how to establish processes such that updating documentation becomes part of the definition of done, how to manage build process across multiple Gitlab repositories, strategies for distributing doc work across engineers through templates, how to scale workloads when you're the lone technical writer in the company, times when dogfooding your own product for docs makes sense and when it does not, pros and cons of Asciidoc versus Markdown, and more docs-as-code topics.

Episode source

pic
Editor guide