Write the Docs
@writethedocs.bsky.social
We’re a global community (and conference) of people who care about documentation. 📝 Next conference: Portland 5/3-5/5 www.writethedocs.org
🗺️ Engineers want docs in their own repos, writers need central oversight. Hridyesh Bisht breaks down four repository patterns, from public-private mirrors to shared Git subdirectories, and the real trade-offs behind each. More details: buff.ly/fwCnBYV
📅 We've published the full schedule for Write the Docs Berlin! This year, we're bringing back Writing Day and the Sunday Welcome Reception. Read up on all the details, get your conference ticket, and submit your Writing Day project: buff.ly/M3L6QYP
💬 "Accessibility for AI" sounds like a win-win, but accessibility is a practice for people that AI just happens to benefit from. Alexandra Klepper shares guidelines for inclusive content that keeps human needs ahead of machine needs. Read more: buff.ly/RTcJHUD
🔌 With an API, no marketing claim survives bad docs. Javier Rubio covers what makes API documentation useful, from OpenAPI and Arazzo to auth, errors and pagination, plus what the AI age changes and what it doesn't. Full abstract: buff.ly/NhYEK5L
⚙️ When products outgrow the docs team, what must be excellent and what's good enough? Elena Baskakova covers GitHub workflows, automated checks and stale-content detection, and why automation moves part of the work into infrastructure rather than removing it: buff.ly/UjcOOel
🤝 Stephan Rayner calls documentation trust infrastructure. Through two stories from his own career, one as a head of data, one as the engineer who lost an argument to an expense policy, the talk shows how good docs level a field decided by power, clout or seniority: buff.ly/f3JE9eI
🗃️ Teams are told to scale docs with AI, then left with messy results. Whitney Burkes shares how a team at Deutsche Bank treated prompts as documentation assets: versioned, reviewed, and built into a shared repository. Learn more: buff.ly/Ryouisc
📈 Most docs teams believe their work is valuable, few can prove it. From research for the State of Docs reports, Tal Gluck digs into which metrics make the case to leadership, which ones actually improve your docs, and why mixing them up frustrates everyone. Learn more: buff.ly/ehJmEVW
🗂️ Good information buried in bad structure is still bad docs. As the first content person on a design system team, Jen Buley inherited hundreds of pages with no one owning the whole. The talk covers how to diagnose the mess, get buy-in, and scale the fixes. More details: buff.ly/CEAeHNT
API examples, error messages, support scripts: all of it flows into AI systems. Oishi Banerjee reframes prompt injection as a writing problem and shows how clearer scope keeps docs safe for people and machines. Read more: buff.ly/X9V6BaU
📊 Two writers, dozens of products, and no way to prove "the docs need work". Anastasia Suboch built a documentation health framework that measures the docs and gets product owners to actually act. Full abstract: buff.ly/LczGq2c
🗓️ Write the Docs Berlin is just two months out, on Sep 6-8, 2026! You can now submit your Writing Day project, attendee guide is updated, and t-shirt shop is open. We're looking for a few more volunteers, with signups closing soon. Do get your ticket, as we expect to sell out. buff.ly/NyHmtza
🧭 AI can write. It can't decide what matters. Kel Raleigh shares a model for modern writing where AI handles the generation and humans own the judgment: what to say, how to frame it, and why it matters. Read more: buff.ly/CyjruV1
📣 Announcing Call for Proposals, Ticket Sales, and Opportunity Grants for Write the Docs Australia 2026. 📅 3–4 Dec | Melbourne | AEDT buff.ly/VnLr7Sa Write the Docs Australia is the conference for technical writers, developers, UX designers, content strategists, and anyone passionate about content.
🔁 Silence is not approval. When Uladzislava Lahun's team improved their docs, users expected more and complained more. The talk covers how a small team built a lightweight feedback loop from surveys, interviews and support signals. Read more: buff.ly/bDsHg3N
🚀 Ever feel stuck racing through content requests one after another? Kate Wilcox makes the case for a moonshot mindset: think bigger, take a wider view, and move from reactive service provider to proactive strategist. Learn more: buff.ly/zhdrTr2
Need to convince your manager on why you should attend Write the Docs Berlin? We've got you covered! ✅ Check out our Convince Your Manager guide for talking points, benefits, and a customizable approval request template. 🔗 Convince your manager: buff.ly/6OS4Lrw 🎟️ Tickets: buff.ly/Oi3jAgx
📣 Announcing Write the Docs Australia 2026. 📅 3–4 December 2026 | Melbourne | AEDT 📝 Call for Proposals opens early July. 🎟️ Tickets on sale July 2026, with tiered pricing and Opportunity Grants. 🤝 Sponsorship opportunities announced soon. buff.ly/6yUO1lL
Just under one week left to apply for an Opportunity Grant for Write the Docs Berlin! Do you want to participate in the conference, but have difficulty with ticket, travel or other costs? Apply before the deadline, and we may be able to support you: buff.ly/XHKK6fP
📣 Announcing our speaker lineup for Write the Docs Berlin! Join us on September 6-8 to hear about metrics, AIs, APIs, moonshots and much more: buff.ly/wWGC1O0 Our call for volunteers has opened, signups open until July 15.
How does your salary compare with other documentarians? 755 documentarians across 48 countries shared their numbers. Median worldwide salary (in USD$) rose from $85,793 to $93,759, but job satisfaction and job security confidence both dropped! buff.ly/lxUc24p
Write the Docs Documentation Salary Survey 2025 Results
The 7th annual WTD Documentation Salary Survey was filled out by 755 documentarians in 48 countries, working across dozens of industries. Check out the full results here!
writethedocs.org
The CFP for Write the Docs Berlin closes in just 36 hours, so this is your last chance to join us on the stage in September: buff.ly/AHbyQdu Tickets are still on sale, and our Opportunity Grant program is open for applications.
⚠️ Less than one week left to submit a talk for Write the Docs Berlin! CFP closes June 1st, 23:59 CEST. Any questions or doubts, read up on our CFP page, ask on our Slack or mail us on berlin@writethedocs.org. Most of all: don't miss the deadline. We look forward to your proposals! buff.ly/OH4sJbt
Call for Proposals
It’s that time of year again: We’re now accepting talk proposals for our next in-person Berlin conference, on September 6-8, 2026. Like last year, we’re also accepting a few pre-recorded talks by r...
writethedocs.org
Thanks for coming to our 14th Portland conference! It was great to have over 400 back at Revolution Hall and 175+ online. We have released all the talk videos, talk sketchnotes, photos, and COC transparency report. We hope to see you again next year in Portland on May 2-4! buff.ly/qCRXH9m
Portland 2026 Recap - Talk Videos, Photos, Sketchnotes, CoC Report
Hi everyone, Our team is slowly emerging from the post-conference recovery period, and we wanted to send out a quick message to thank everyone for helping to make Write the Docs Portland 2026 such ...
writethedocs.org
This is a reminder that the deadline for our Berlin Call for Proposals is in just over two weeks on June 1st. Make sure to get your proposals in on time! We do not accept late submissions. You can still apply for a grant until June 29, and we've already opened ticket sales: buff.ly/1XN1r6n
Reminder for Call for Proposals, Tickets, and Opportunity Grants
We hope you are looking forward to our Berlin conference as much as we are! Today is mostly a reminder that we’re accepting talk proposals until June 01, 2026. Opportunity Grants are still open as ...
writethedocs.org
A big thanks to all the wonderful meetup and community groups from all over the globe, who make this community what it is. We had representation from some of the meetups in person in Portland, and it was awesome to have them here. buff.ly/SS2wBit #writethedocs
A big thanks to all the wonderful meetup and community groups from all over the globe, who make this community what it is. We had representation from some of the meetups in person in Portland, and it was awesome to have them here. www.writethedocs.org/meetups/ #writethedocs
Folks at Write the Docs Portland, what did you work on at yesterday’s Unconference sessions? What insights came through? Let us know in the comments! Today's speakers: Rakesh Pasupuleti, Alina Desiatnikova, Busayo Ojo, Ethan Palm, Adam Michael Wood, and Alex Garnett. #writethedocs
