Sign in

Write the Docs

@writethedocs.bsky.social
223 followers 3 following 249 posts

We’re a global community (and conference) of people who care about documentation. 📝 Next conference: Berlin Sep 6-8 www.writethedocs.org

PostsRepliesMedia
Write the Docs @writethedocs.bsky.social · 23/09/2026
Thank you again to everyone who participated in Write the Docs Berlin 2026! We published the talk videos, sketchnotes and photos. You'll find them all, and more, in our recap: buff.ly/7wsU4kV
051
Write the Docs @writethedocs.bsky.social · 10/09/2026
Sketchnote from WTD Berlin talk, thanks to Dennis Dawson. Uladzislava Lahun - Silence Is Not Approval: When Better Docs Create More Feedback #writethedocs
000
Write the Docs @writethedocs.bsky.social · 10/09/2026
Sketchnote from WTD Berlin talk, thanks to Dennis Dawson. Elena Baskakova - Good Enough at Scale: Documentation Infrastructure Under Capacity Constraints #writethedocs
000
Write the Docs @writethedocs.bsky.social · 10/09/2026
Sketchnote from WTD Berlin talk, thanks to Dennis Dawson. Jen Buley - Structure after the fact: Bringing content strategy to existing docs for a design system #writethedocs
010
Write the Docs @writethedocs.bsky.social · 08/09/2026
Sketchnote from WTD Berlin talk, thanks to Dennis Dawson. Whitney Burkes - Writing Less, Owning More: The Shift in Technical Writing #writethedocs
020
Write the Docs @writethedocs.bsky.social · 08/09/2026
Sketchnote from WTD Berlin talk, thanks to Dennis Dawson. Hridyesh Bisht - Mapping Your Docs-as-Code Repository: Navigating the Architectural Evolution of Repositories #writethedocs
010
Write the Docs @writethedocs.bsky.social · 08/09/2026
Sketchnote from WTD Berlin talk, thanks to Dennis Dawson. Javier Rubio - Documenting APIs: new era, same craft #writethedocs
031
Write the Docs @writethedocs.bsky.social · 08/09/2026
Sketchnote from WTD Berlin talk, thanks to Dennis Dawson. Alexandra Klepper - Write inclusive, people-first language about AI #writethedocs
062
Write the Docs @writethedocs.bsky.social · 08/09/2026
Sketchnote from WTD Berlin talk, thanks to Dennis Dawson. Kate Wilcox - Moonshot mindset: A tech writer's guide to thinking big and breaking free from the GDZ #writethedocs
031
Write the Docs @writethedocs.bsky.social · 08/09/2026
Sketchnote from WTD Berlin talk, thanks to @Dennis Dawson. Tal Gluck - Proving and improving the value of your docs #writethedocs
031
Write the Docs @writethedocs.bsky.social · 08/09/2026
Sketchnote from WTD Berlin talk, thanks to @Dennis Dawson. Kel Raleigh - Beyond Automation: Human Judgment as the Strategic Core of Business Writing #writethedocs
030
Write the Docs @writethedocs.bsky.social · 07/09/2026
Unconference sessions at Write the Docs Berlin can be about anything. Linting, DocOps, git, or... Wingspan 🐦‍⬛
000
Write the Docs @writethedocs.bsky.social · 06/09/2026
Writing Day is in full swing, and the terrace is looking great for our Welcome Reception tonight. Virtual ticket sales close at 15:00, so last chance to get yours!
010
Write the Docs @writethedocs.bsky.social · 06/09/2026
Almost ready for Write the Docs Berlin! Join us from 8:30 onwards, with opening presentations starting at 9:30. And virtual starting tomorrow.
041
Write the Docs @writethedocs.bsky.social · 05/09/2026
Our team started setup for the Berlin conference yesterday, and it's starting to look amazing ✨️ We're looking forward to welcoming you all at Writing Day, the Welcome Reception or later, either on-site or virtual! We open on-site doors Sunday 8:30 and start the introduction at 9:30.
010
Write the Docs @writethedocs.bsky.social · 02/09/2026
🎉 Write the Docs Berlin starts this Sunday! Writing Day, two days of talks, Unconference, and social events - in person and online. Everything you need to know before you arrive: www.writethedocs.org/conf/berlin/...
011
Write the Docs @writethedocs.bsky.social · 01/09/2026
The Write the Docs 2026 Documentation Salary Survey is open! Anonymous, takes ~10 minutes, open to anyone doing documentation work anywhere in the world. Results published free for everyone. Closes 𝟯𝟭 𝗝𝗮𝗻𝘂𝗮𝗿𝘆 𝟮𝟬𝟮𝟳. buff.ly/ay6PHWn
033
Write the Docs @writethedocs.bsky.social · 31/08/2026
📣 Have ideas already for a Lightning Talk or leading an unconference session? Signups are open now! Even (especially?) if you've never done it before, you are welcome to run a session on something that interests you, or get 5 minutes on our stage! Read more on: buff.ly/e0OxZzI buff.ly/fnqExkm
010
Write the Docs @writethedocs.bsky.social · 26/08/2026
✍️ What do you want to get out of Writing Day? Learn Git, get feedback on your resume, talk shop about AI or API docs, or dig into a documentation project with others. It's all happening Sunday, Sept 6 in Berlin: buff.ly/4By8z5X
130
Write the Docs @writethedocs.bsky.social · 25/08/2026
Our August update this year is a bit more philosophical than usual. Thinking a bit more about our place in the ecosystem in a time of change, and what has worked in the past to guide us into the future. We hope you'll give it a read. buff.ly/07u8bDN
020
Write the Docs @writethedocs.bsky.social · 25/08/2026
Write the Docs Berlin has two social events. On Sunday, meet us at bUm for the Welcome Reception, right after Writing Day. On Monday, at Straßenbräu Ausschank 2 from 19:00. Read all the details on buff.ly/nvI1nK6 Conference badge required. We serve alcoholic and non-alcoholic drinks and snacks
000
Write the Docs @writethedocs.bsky.social · 24/08/2026
We’re excited to have Fern as a sponsor! Fern helps teams deliver SDKs and API docs they're proud to share. Start with an API spec and generate SDKs in multiple languages and interactive API documentation tailored to your brand. 💡 Stop by and chat with them at WTD Berlin, Sep 6-8: buff.ly/sdviwYE
010
Write the Docs @writethedocs.bsky.social · 21/08/2026
⚡ Lightning Talks Monday and Tuesday after lunch! Signups open Monday Aug 31. Looking for inspiration for your 5 minutes on the Write the Docs stage? Have a look at least year's talks: buff.ly/QCq3s7U Read more about Lightning Talks on buff.ly/m2HRmpK and join us on Sep 6-8 at WTD Berlin
youtube.com
Lightning Talks - Day 1
* Ashley Gordon - How I convinced 105 colleagues to help me Write the Docs * Jewel Darger-Sacher - From Dry Doc to Desert (annual acculturation for challenging conditions) * Matthew Brandabur Writers…
010
Write the Docs @writethedocs.bsky.social · 19/08/2026
We’re excited to have GitBook as a sponsor! GitBook is a technical documentation platform for building and maintaining knowledge. GitBook connects your docs, product, and users into a continuous feedback loop that improves with every interaction. 💡 Stop by and chat on Sep 6-8: buff.ly/sdviwYE
030
Write the Docs @writethedocs.bsky.social · 18/08/2026
At Write the Docs events, we want to foster inclusivity and collaboration. One way we do this? The Pac-Man Rule: when you find yourself chatting in a group, make yourselves more approachable with this rule from our co-founder Holscher: buff.ly/SKUagUP Join us in Berlin on Sep 6-8: buff.ly/Cup7rwD
056
Write the Docs @writethedocs.bsky.social · 17/08/2026
It wouldn’t be a Write the Docs event without the Unconference! Participate in insightful discussions and community-driven learning, next to our talks on the stage. Join us Sep 6-8 in Berlin, and experience it for yourself! Learn more: buff.ly/0fGaDBT
030
Write the Docs @writethedocs.bsky.social · 14/08/2026
We’re excited to have Mintlify sponsoring Write the Docs Berlin! Mintlify makes it easy for teams to create modern, reliable documentation that grows with their product. Their platform reaches 100M+ developers every year and powers the documentation of 20,000+ companies. Tickets: buff.ly/sdviwYE
020
Write the Docs @writethedocs.bsky.social · 13/08/2026
📝Join us for Writing Day at Write the Docs Berlin! This Sunday is all about you and the community! 🤝 Contribute to exciting projects 🚀 Level up together 👥 Network with others Got a project? Submit it by Aug 17 to get featured on our website! Or bring your ideas on the day buff.ly/LjswDir
052
Write the Docs @writethedocs.bsky.social · 11/08/2026
📅 Only 4 weeks until Write the Docs Berlin, on Sep 6-8! Alongside the talks we've got Writing Day, roundtable discussions, and two evening socials. Submit Writing Day projects by Aug 17, and make sure to get your ticket soon: www.writethedocs.org/conf/berlin/...
010
Write the Docs @writethedocs.bsky.social · 04/08/2026
🗺️ 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
030
Write the Docs @writethedocs.bsky.social · 31/07/2026
📅 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
021
Write the Docs @writethedocs.bsky.social · 30/07/2026
💬 "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
020
Write the Docs @writethedocs.bsky.social · 29/07/2026
🔌 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
050
Write the Docs @writethedocs.bsky.social · 28/07/2026
⚙️ 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
000
Write the Docs @writethedocs.bsky.social · 27/07/2026
🤝 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
001
Write the Docs @writethedocs.bsky.social · 27/07/2026
🗃️ 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
011
Write the Docs @writethedocs.bsky.social · 24/07/2026
📈 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
050
Write the Docs @writethedocs.bsky.social · 22/07/2026
🗂️ 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
020
Write the Docs @writethedocs.bsky.social · 21/07/2026
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
022
Write the Docs @writethedocs.bsky.social · 17/07/2026
📊 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
020
Write the Docs @writethedocs.bsky.social · 16/07/2026
🗓️ 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
011
Write the Docs @writethedocs.bsky.social · 15/07/2026
🧭 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
110
Write the Docs @writethedocs.bsky.social · 15/07/2026
📣 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.
121
Write the Docs @writethedocs.bsky.social · 13/07/2026
🔁 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
032
Write the Docs @writethedocs.bsky.social · 10/07/2026
🚀 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
000
Write the Docs @writethedocs.bsky.social · 02/07/2026
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
011
Write the Docs @writethedocs.bsky.social · 25/06/2026
📣 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
124
Write the Docs @writethedocs.bsky.social · 23/06/2026
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
011
Write the Docs @writethedocs.bsky.social · 18/06/2026
📣 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.
010
Write the Docs @writethedocs.bsky.social · 09/06/2026
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
writethedocs.org
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!
141