The Modern Technical Writer’s Guide to Docs-as-Code

### Building Documentation Workflows with Docusaurus, GitHub, and CI/CD

Technical writing is rapidly evolving alongside developer workflows, AI tooling, and modern software practices. Docs-as-code skills like GitHub collaboration, Markdown, pull requests, CI/CD, and static site generators are increasingly appearing across technical writing and developer documentation roles.
But for many writers, these workflows can still feel intimidating or disconnected from traditional documentation practices.
In this practical session, we’ll walk through how modern documentation teams build, review, deploy, and scale documentation using docs-as-code workflows centered around Docusaurus.

Topics include:

• Docs-as-code fundamentals
• Documentation architecture and organization
• Markdown and MDX workflows
• GitHub collaboration and pull request reviews
• CI/CD with GitHub Actions
• Deployments with Netlify and Vercel
• Real-world tradeoffs around scaling and maintainability

We'll also explore the modern documentation lifecycle end-to-end:
Writer → Pull Request → Review → GitHub Actions → Deploy → Live Docs
This session is designed to make docs-as-code approachable for technical writers without requiring a software engineering background.
Ideal for:

• Technical writers transitioning into docs-as-code
• Writers using MadCap Flare, DITA XML tools, Confluence, or Microsoft Word
• Freelancers and consultants
• Developer documentation professionals
• Anyone looking to stay competitive in the modern technical writing market

The event also includes networking with technical writers and developer documentation professionals from across the Bay Area.
Seating is limited due to room capacity. Early RSVP is recommended. Registration is available through both Meetup and Luma.

## Event Agenda

5:00–5:20 PM — Welcome + networking
5:20–5:30 PM — Community updates + Technical Writing Scouting Report
5:30–6:20 PM — Presentation
6:20–6:30 PM — Q&A + discussion
6:30–6:45 PM — Networking + closing remarks

## Speaker Bio

Doug Purcell is a San Francisco-based technical writer and organizer of Write the Docs Bay Area. He has created software and hardware documentation across the cybersecurity, enterprise software, and server industries, with a focus on developer workflows, infrastructure, and modern documentation practices.
This is not a Library-sponsored event. The City of Santa Clara is neither responsible nor liable for information provided by users of the Library meeting rooms.

This is not a Library-sponsored event.The City of Santa Clara is neither responsible nor liable for information provided by users of the Library meeting rooms.