Write the Docs Prague 2017
2017-09-10..2017-09-12
Prague, Czechia
[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]
| title | author | length |
|---|---|---|
| What nobody tells you about documentation | Daniele Procida | 29m |
Clear claim: documentation breaks into four documentation types — tutorials, how‑tos, reference, explanations — and each must be written, organized and… | ||
| Aw Snap! The Docs, They Are A-Changin’ | Kate Wilcox | 30m |
Examines concrete claims and evidence: a survey of 150 responses (55% with >16 years experience) and the surprising datum that 10% reported anything goes for… | ||
| Main Takeaways After One Year in Documentation | Meike Chabowski | 23m |
Claim: documentation is a must‑have, not a nice‑to‑have; it must be ready 8–12 weeks before release. The team maintains 12,000 pages using a single‑source… | ||
| Writing great "getting started" documentation | Tim Rogers | 28m |
A payments API company with a team of four builds a linear getting-started guide that lives beside the Swagger reference, integrates with the dashboard, and… | ||
| Lightning Talks Day 1 | 24m | |
Six six minute slots give concrete takeaways not fluffy topic restatements: Self-Care prevents burnout with a daily nourishing action and a community table for… | ||
| Design critique guidelines make feedback easier | Christy Lutz | 23m |
Claims that design critique guidelines cut pain and speed decisions by prescribing a scope statement, explicit feedback guidelines, and stakeholder ownership… | ||
| Microaggressions & Inclusive Language | Cory Williamson-Cardneau | 25m |
Argues that naming specific microaggressions and changing immediate behavior matters more than vague pledges: shows how a single ally moment turns a hidden… | ||
| A content manager's guide to crowdsourcing the docs | Becky Todd | 27m |
Shows that crowdsourcing works only with process: build a writing toolkit, templates and checklists, run edits in pull requests, and coach volunteers. Reports… | ||
| Even Naming This Talk Is Hard | Ruthie BenDor | 26m |
Names determine whether code is approachable or inscrutable: concrete examples include a to‑do app prototype that runs in a Docker container while its Redux… | ||
| Telling a Great Story on GitHub | Lauri Apple | 31m |
A six-month audit finds 400 repositories littered with half-finished projects and inconsistent docs; implementation of mandatory open-source guidelines, README… | ||
| Documentation beyond words | Chris Ward | 17m |
Uploader notes a technical error so the video is shorter than advertised. Claims images and interactive media beat verbose restatements and shows concrete… | ||
| Requirements that you didn't know were there | Lesia Zasadna | 27m |
Hidden requirements turn on stakeholders not topics: analytics show users getting stuck but product owners ignore numbers until presented as cost savings; a… | ||
| Writing a book in 2017 | Thomas Parisot | 25m |
Describes writing a developer book as an open source project: replaces fragile ODT workflows with folders on GitHub, uses asciidoc for content, automates HTML… | ||
| Trustworthy and Sensible API Docs with GraphQL | Garen Torikian | 26m |
Argues that GraphQL makes reference docs trustworthy by turning the schema into executable documentation so documentation is the code rather than a separate… | ||
| Lightning Talks Day 2 | 21m | |
Five rapid case studies give concrete takeaways: community docs scale a workshop from 2,000 to 10,000 attendees by publishing coach guides and event… | ||
| Hi, my name is README! | Raphael Pierzina | 25m |
Maintainer experience crystallizes into concrete advice: README files that state the actual claim, list the single preferred install command, and show a… | ||
| Documenting your software’s last days | Daniel D. Beck | 23m |
Delineates concrete steps: count your users (daily actives, API tokens, billing clients), inventory every channel (email, transactional notices, blog, UI… | ||
| Tech Writers Without Borders | Stuart Culshaw | 27m |
Volunteers audit and rewrite camp materials, migrate them into a Moodle site with Moodle mobile offline downloads, and produce a curated set of 40 modules in… | ||
| nothing matches | ||