Write the Docs Prague 2022
2022-09-11..2022-09-13
-- online --
[Write the Docs Prague 2014, Write the Docs Prague 2017, Write the Docs Prague 2020, Write the Docs Prague 2021, Write the Docs Prague 2022]
who it's for
technical writers, documentation managers, docs engineers, localization engineers, content designers, accessibility specialists, community managers
topics
mandatory preview checks in CI; TypeScript CLI docs generator; unit-test code examples in docs; Veil linting with GitHub Action; alt-text and trademark enforcement; Markdoc markdown superset; in-app contextual help and product tours; Crowdin to GitHub localization workflow; SEO and discoverability for docs; glossary and style standardization; git strategies for documentation; accessibility exercises with teams
| title | author | length |
|---|---|---|
| Community Update | Mikey Ariel | 24m |
Community update lists concrete numbers and policies: 16,000 Slack members and almost 10,000 mailing list subscribers, live captions on stage and talks… | ||
| Maintaining Documentation: Make It Easy! | Emilia Juda Özbay | 38m |
Redesign for TypeScript adds a command-line docs generator wired into CI and local workflows, with mandatory preview checks on every PR and a simple CLI for… | ||
| How I convinced my boss to build our docs team | Karissa Van Baulen | 45m |
A concrete playbook: run a four-part audit of people/process, appearance, content and competitors, collect basic analytics and user feedback via Google… | ||
| Documentation as Marketing? From Conflict to Collaboration | Mano Toth | 46m |
Argues the conflict between documentation and marketing is false and shows concrete fixes: evidence of fragmented three-part sites, examples of tooling and… | ||
| Beyond spell checking - what else can we check automatically? | Tibs | 42m |
Argues for linting docs beyond spelling with concrete checks: acronym-first-use enforcement, registered‑mark checking that flags missing ® on first mentions… | ||
| Cultivating a Stakeholder Network for Our Docs | Taylor Cole | 45m |
Rewrites of Splunk’s custom search command docs produce task-based guidance and a standardized glossary across docset SDK and examples repo but initial release… | ||
| The Art of Asking Questions | Jeff Smith | 32m |
Argues that curiosity is a job requirement and gives three actionable pillars: confidence, discernment, tenacity. Recommends concrete tactics — narrow… | ||
| Improve Customer Adoption with UI Help | Prashant Mathapathi | 33m |
Claims that adding contextual help inside the app increases trial-to-paid conversion and reduces drop-off by keeping users from leaving the UI. Implementation… | ||
| Toward the broader globalization of Open Source | Melissa Black, Asma Kacem | 33m |
Community converts the Turing Way handbook into multiple languages using a documented, crowdsourced workflow that starts with localization not as an… | ||
| Creating documentation for the African audience | Benny Ifeanyi Iheagwara, Mustapha Rufai | 39m |
Surveyed African companies report concrete numbers and tools: Google finds 716,000 developers across the continent, startups list 24,000 HQs, Paga serves 18… | ||
| Two years of Markdoc: what we’ve learned about balancing developer and author experience | Ryan Paul | 42m |
Markdoc is a Markdown superset that Stripe builds and uses to power over a thousand pages of docs, released as open source and pulling about 7000 npm downloads… | ||
| ADHD and its impact on the Creative Process for Writers | Ty Smith | 48m |
Claim: ADHD often produces a frontloaded working rhythm—lots of upfront research and tooling then concentrated bursts of output—illustrated with a concrete… | ||
| Can we NOT do docs at the eleventh hour? Mmmmmaybe. | Abi Sutherland | 10m |
Claim: make documentation part of estimates and put a documentation task on the pull request so PRs cannot merge unless the documentation task is done. Use… | ||
| Speech acts - a thing we all do, without necessarily knowing | Kat Stoica Ostenfeld | 05m |
Defines speech acts as three parts and claims documentation fails when intent and utterance diverge; demonstrates with two concrete examples — “Do you know… | ||
| Tips to learn from scripts of Christopher Nolan | Mayur Patil | 07m |
A set of concrete rules: treat writing like Nolan’s scripts by take two to three years to develop conceptually but execute in sprints not years, pairing… | ||
| Git strategies for documentation | James Baross | 07m |
Argues for a concrete repo layout: create a branch per release so each software version keeps its docs, keep a master branch for shared fixes, and cherry-pick… | ||
| Running an accessibility exercise with your team | Emily Axel | 04m |
Runs an accessibility training used with two different teams that is well received and practical it pairs Alexandra White's accessibility style guide with a… | ||
| nothing matches | ||