This is a cross-post of a WTD West Coast Quorum event:
Today's technical writers are often expected to use complex tool chains to deliver documentation. The adoption of a developer style workflows means that, as well as basic editing, writers need to review content on their local workstation before pushing changes for further review and publication. Ideally, they would also run any verification tools locally to catch errors when they are still easy to fix.
Setting up the required tools locally can be complex and the result can be fragile. Docker can hide the complexity and provide a consistent experience for all writers, no matter their individual technology skills or workstation setup. This talk introduces Docker on the desktop by showing some of the problems with the maintenance of a simple Hugo docs website.
Alec Clews is a software geek who currently works as a Developer Relations Advocate at PaperCut Software in Melbourne, Australia. He started using Docs as Code in 2017 with old school UNIX tools (m4, sed, ...), but has since improved his content productivity with Hugo, Docker, Plantuml, Make, and many other tools old and new. He has been working in IT for over twenty years.
7:00 to 7:05 - Announcements
7:05 to 7:50 - Presentation and Q&A
7:50 to 8:00 - Breakout rooms by meetup - Meet with your local meetup organizers and members to say hi to other people in your area!
*Note that our agenda does not include an icebreaking activity this time because our speaker needs more time for the topic.
The Quorum program brings together various local Write the Docs meetup chapters that are in a common time zone to provide quarterly super meetups over Zoom throughout the year. The following meetups are sponsoring this Meetup event:
Australia - https://www.meetup.com/Write-the-Docs-Australia/
Bay Area, CA - https://www.meetup.com/Write-the-Docs-Bay-Area/
Los Angeles, CA - https://www.meetup.com/Write-the-Docs-LA/
Portland, OR - https://www.meetup.com/Write-The-Docs-PDX/
Seattle, WA - https://www.meetup.com/Write-The-Docs-Seattle/
This meeting will be recorded. Also be advised that the Zoom room for this meeting is capped at 100 attendees. If more than 100 individuals RSVP for the event, only the first 100 attendees who enter the Zoom room will be able to attend.