FOSS DOCS 101 - Keep It Simple, Present
Offered By: EuroPython Conference via YouTube
Course Description
Overview
Explore the fundamentals of technical communication for open-source projects in this EuroPython Conference talk. Learn how to improve documentation for better user onboarding, code contribution workflows, and overall project accessibility. Discover key principles including tone, style, process management, structure, and contribution workflows. Gain insights into content strategy, understanding user needs, error message crafting, and community engagement. Examine the evolution of documentation practices, the importance of a unified tool chain, continuous integration for docs, and strategies for content curation. Understand when to consider hiring a dedicated technical writer and how to foster a documentation-centric culture within your project.
Syllabus
Intro
Mikeys background
Help desk
Why documentation
How documentation used to be
How to help a software project
Pros
Join the Docs Club
Content Strategy
Users
What do they want
When do they need it
Error messages
Why
Bugs
Who are you
Administrator
Developers
Arch Linux Wiki
Red Hat
Working on new guides
DevOps for docs
Unified tool chain
Continuous integration
Content curation
Community engagement
Outreach efforts
Example
Templates
Collaboration
Documentation conferences
Everyone can care
QA Questions
Organizational Position
When to hire a writer
Taught by
EuroPython Conference
Related Courses
A Brief History of Data StorageEuroPython Conference via YouTube Breaking the Stereotype - Evolution & Persistence of Gender Bias in Tech
EuroPython Conference via YouTube We Can Get More from Spatial, GIS, and Public Domain Datasets
EuroPython Conference via YouTube Using NLP to Detect Knots in Protein Structures
EuroPython Conference via YouTube The Challenges of Doing Infra-As-Code Without "The Cloud"
EuroPython Conference via YouTube