Fosstodon

Write the DocsIt’s the last day to submit your Writing Day project, and be featured on our blog! In just 11 days, our Portland conference kicks off on May 4th with opportunities to collaborate, contribute to open-source projects, and improve documentation together.Submit your project by the end of the day, and we’ll include it on the website: <a href="https://www.writethedocs.org/conf/portland/2025/writing-day/" target="_blank" rel="nofollow noopener noreferrer" translate="no">https://www.writethedocs.org/conf/portland/2025/writing-day/</a>You’ll be in great company.<a href="https://fosstodon.org/tags/WriteTheDocs" class="mention hashtag" rel="tag">#WriteTheDocs</a> <a href="https://fosstodon.org/tags/CollaborativeWriting" class="mention hashtag" rel="tag">#CollaborativeWriting</a> <a href="https://fosstodon.org/tags/OpenSourceDocs" class="mention hashtag" rel="tag">#OpenSourceDocs</a>

Daniel D. BeckI liked watching Andrea Kao’s FOSS Backstage talk, particularly the way Andrea talked about the word “content”: it doesn't just diminish the work, it also diminishes the people do the work. <a href="https://www.youtube.com/watch?v=lmwpPyrrPdY" rel="nofollow noopener noreferrer" translate="no" target="_blank">https://www.youtube.com/watch?v=lmwpPyrrPdY</a> I took some longer notes here: <a href="https://ddbeck.com/notes/diminishing-content/" rel="nofollow noopener noreferrer" translate="no" target="_blank">https://ddbeck.com/notes/diminishing-content/</a> <a href="https://mastodon.social/tags/WriteTheDocs" class="mention hashtag" rel="nofollow noopener noreferrer" target="_blank">#WriteTheDocs</a>

Write the DocsSwing by DeveloperHub’s booth at WTD! Whether you want to master building world-class docs or prove you’re the ultimate technical writing champ in our Technical Writing Olympics, we’ve got something for you. Oh, and did we mention? You could win a pair of Beats earphones! 🎧🔥Get your ticket: <a href="https://www.writethedocs.org/conf/portland/2025/" target="_blank" rel="nofollow noopener noreferrer" translate="no">https://www.writethedocs.org/conf/portland/2025/</a><a href="https://fosstodon.org/tags/writethedocs" class="mention hashtag" rel="tag">#writethedocs</a>

QUnitEver wondered how beforeEach works in unit test frameworks? Check out our new lifecycle diagram!<a href="https://qunitjs.com/lifecycle/" target="_blank" rel="nofollow noopener noreferrer" translate="no">https://qunitjs.com/lifecycle/</a>People generally guess right when it comes to ordering, so why a diagram?We want to show that the order is guaranteed, and showcase what's possible when you depend on it.Thanks to FND, Jan, and NullVoxPopuli for improving and promoting this work! H/T <a href="https://hachyderm.io/@FND" class="u-url mention">@FND</a> <a href="https://hci.social/@simulo" class="u-url mention">@simulo</a> <a href="https://mastodon.coffee/@nullvoxpopuli" class="u-url mention">@nullvoxpopuli</a> <a href="https://fosstodon.org/tags/qunit" class="mention hashtag" rel="tag">#qunit</a> <a href="https://fosstodon.org/tags/WriteTheDocs" class="mention hashtag" rel="tag">#WriteTheDocs</a> <a href="https://fosstodon.org/tags/TechnicalWriting" class="mention hashtag" rel="tag">#TechnicalWriting</a> <a href="https://fosstodon.org/tags/SoftwareDocumentation" class="mention hashtag" rel="tag">#SoftwareDocumentation</a> <a href="https://fosstodon.org/tags/documentation" class="mention hashtag" rel="tag">#documentation</a> <a href="https://fosstodon.org/tags/TDD" class="mention hashtag" rel="tag">#TDD</a>

Write the DocsWe’re excited to announce that ReadMe is one of our wonderful sponsors at Write the Docs Portland. 🙌 ReadMe transforms static API docs into interactive developer hubs. Find them at their booth May 5-6.Buy tickets: <a href="https://www.writethedocs.org/conf/portland/2025/" target="_blank" rel="nofollow noopener noreferrer" translate="no">https://www.writethedocs.org/conf/portland/2025/</a><a href="https://fosstodon.org/tags/writethedocs" class="mention hashtag" rel="tag">#writethedocs</a>

Write the DocsWe are excited to announce our Keystone sponsor - Mintlify! 💫 Mintlify helps you create beautiful documentation that converts users. 💡 Visit them at their booth throughout the WTD weekend.Tickets available: <a href="https://www.writethedocs.org/conf/portland/2025/" target="_blank" rel="nofollow noopener noreferrer" translate="no">https://www.writethedocs.org/conf/portland/2025/</a><a href="https://fosstodon.org/tags/writethedocs" class="mention hashtag" rel="tag">#writethedocs</a>

indieA pic I took on the streets of <a href="https://kolektiva.social/tags/Portland" class="mention hashtag" rel="nofollow noopener noreferrer" target="_blank">#Portland</a> # 363 days ago, area within walking distance of <a href="https://kolektiva.social/tags/Revolution" class="mention hashtag" rel="nofollow noopener noreferrer" target="_blank">#Revolution</a> Hall.I've remained publicly silent on my <a href="https://kolektiva.social/tags/WriteTheDocs" class="mention hashtag" rel="nofollow noopener noreferrer" target="_blank">#WriteTheDocs</a> conference attendance last year because it was .... a shitty conference.And today I'll tell you why it was a shitty conference.There was a self-proclaimed "extrovert" who got up on stage and vomited bullshit about how she was representing <a href="https://kolektiva.social/tags/Nginx" class="mention hashtag" rel="nofollow noopener noreferrer" target="_blank">#Nginx</a>. I did not plan to give a talk, but when I woke up the last day of the conference, I really had this pressing intuition that I should speak up for the talent that was maybe intimidated ... that NO, you don't need a fucking Macbook to be a technical writer... not all technical writing is about computer-related things. But then did I find out ... what that Nginx "extrovert" was really there to do was be the shithead <a href="https://kolektiva.social/tags/censoring" class="mention hashtag" rel="nofollow noopener noreferrer" target="_blank">#censoring</a> the indigenous voice that wanted to get on stage and tell everybody that not all <a href="https://kolektiva.social/tags/TechnicalWriting" class="mention hashtag" rel="nofollow noopener noreferrer" target="_blank">#TechnicalWriting</a> has to be about <a href="https://kolektiva.social/tags/technology" class="mention hashtag" rel="nofollow noopener noreferrer" target="_blank">#technology</a>. But that snooty white supremacist bitch rejected this talk.

Amy HupeIn the course, you'll learn how to:- understand and prioritise your readers - name and organise your documentation - make documentation clear and easy to read - review and test documentationLet me know if you have any questions, and please share far and wide!<a href="https://social.design.systems/tags/DesignSystems" class="mention hashtag" rel="nofollow noopener noreferrer" target="_blank">#DesignSystems</a> <a href="https://social.design.systems/tags/WriteTheDocs" class="mention hashtag" rel="nofollow noopener noreferrer" target="_blank">#WriteTheDocs</a>

Write the DocsJust one month until we gather in Portland, Oregon! 🌲 If you’ve been to Portland, where are your favorite places to visit or explore?View our latest blog on how to join our Slack channel, Writing Day submissions, participating in the conference, and more. <a href="https://www.writethedocs.org/conf/portland/2025/news/one-month-out/" target="_blank" rel="nofollow noopener noreferrer" translate="no">https://www.writethedocs.org/conf/portland/2025/news/one-month-out/</a><a href="https://fosstodon.org/tags/writethedocs" class="mention hashtag" rel="tag">#writethedocs</a>

Write the DocsCollaborate with other documentarians on day one of our Portland Conference: Writing Day! This is your chance to contribute to open-source projects, improve documentation, and connect with fellow documentarians. 📍Submit your project in advance! As always, attendees have the option to bring a project, sign up on site, and announce it during Writing Day.Submit your Writing Day project by 4/23 to be included on the website: <a href="https://www.writethedocs.org/conf/portland/2025/writing-day/" target="_blank" rel="nofollow noopener noreferrer" translate="no">https://www.writethedocs.org/conf/portland/2025/writing-day/</a> <a href="https://fosstodon.org/tags/writethedocs" class="mention hashtag" rel="tag">#writethedocs</a> <a href="https://fosstodon.org/tags/WritingDay" class="mention hashtag" rel="tag">#WritingDay</a>

Marcin SJ :blobfoxfingerguns:Currently documenting: custom fields in GitLab issues, epics, etc. I don't think this screenshot would pass peer review 🥸<a href="https://hachyderm.io/tags/ProjectManagement" class="mention hashtag" rel="nofollow noopener noreferrer" target="_blank">#ProjectManagement</a> <a href="https://hachyderm.io/tags/Agile" class="mention hashtag" rel="nofollow noopener noreferrer" target="_blank">#Agile</a> <a href="https://hachyderm.io/tags/GitLab" class="mention hashtag" rel="nofollow noopener noreferrer" target="_blank">#GitLab</a> <a href="https://hachyderm.io/tags/WriteTheDocs" class="mention hashtag" rel="nofollow noopener noreferrer" target="_blank">#WriteTheDocs</a>

Write the DocsOur final (free) Docs in Discussion call is tomorrow at 12:00 pm PST! Grab your spot and get ready to hear from speaker Jodie Landes and conference host Joe Meersman. You’ll learn about Jodie’s background, why they’re excited about the conference, and get a view into Jodie’s talk, “Unifying Documentation: A Tale of Two Security Giants”. 🔍 Register at <a href="https://ti.to/writethedocs/write-the-docs-portland-2025/with/free-livestream" target="_blank" rel="nofollow noopener noreferrer" translate="no">https://ti.to/writethedocs/write-the-docs-portland-2025/with/free-livestream</a><a href="https://fosstodon.org/tags/WTDPortland2025" class="mention hashtag" rel="tag">#WTDPortland2025</a> <a href="https://fosstodon.org/tags/writethedocs" class="mention hashtag" rel="tag">#writethedocs</a>

Write the DocsReady to harness the power of the Kraken to your advantage? 🦑 In this talk, Ravind Kumar will explore lessons learned from building and maintaining custom docs toolchains, tackling single sourcing, cross-referencing, and other challenges. Ravind will dive into whether to put our Krakens into retirement or build new ways to problem solve. Learn More: <a href="https://www.writethedocs.org/conf/portland/2025/speakers/#speaker-ravind-kumar-embracing-the-kraken-how-to-build-a-docs-toolchain-monster-and-why-it-s-ok-ravind-kumar" target="_blank" rel="nofollow noopener noreferrer" translate="no">https://www.writethedocs.org/conf/portland/2025/speakers/#speaker-ravind-kumar-embracing-the-kraken-how-to-build-a-docs-toolchain-monster-and-why-it-s-ok-ravind-kumar</a><a href="https://fosstodon.org/tags/writethedocs" class="mention hashtag" rel="tag">#writethedocs</a>

Write the DocsIn the world of technical documentation, merging two established systems is no small feat. Jodie Landes will share insights on how they launched a unified documentation platform and showcase how a Docs as Code approach can successfully scale to meet enterprise needs. 🚀Jode will also be our final Docs in Discussion speaker on April 1!Learn more: <a href="https://www.writethedocs.org/conf/portland/2025/speakers/#speaker-jodie-landes-unifying-documentation-a-tale-of-two-security-giants-jodie-landes" target="_blank" rel="nofollow noopener noreferrer" translate="no">https://www.writethedocs.org/conf/portland/2025/speakers/#speaker-jodie-landes-unifying-documentation-a-tale-of-two-security-giants-jodie-landes</a><a href="https://fosstodon.org/tags/writethedocs" class="mention hashtag" rel="tag">#writethedocs</a>

Write the DocsHeather Zoppetti will share how an unconventional career path-spanning from software engineer to knitwear design to technical writing—can be a powerful asset. Learn how embracing your unconventional experiences can shape a career you love and offer unique perspectives in technical communication. Learn more: <a href="https://www.writethedocs.org/conf/portland/2025/speakers/#speaker-heather-zoppetti-knitting-together-a-technical-writing-career-heather-zoppetti" target="_blank" rel="nofollow noopener noreferrer" translate="no">https://www.writethedocs.org/conf/portland/2025/speakers/#speaker-heather-zoppetti-knitting-together-a-technical-writing-career-heather-zoppetti</a> <a href="https://fosstodon.org/tags/writethedocs" class="mention hashtag" rel="tag">#writethedocs</a>

Write the DocsSee you at today’s Docs in Discussion call at 12:00 pm PST with Portland conference speakers Manny Silva, Alex Garnett, and host Joe Meersman!Register: <a href="https://ti.to/writethedocs/write-the-docs-portland-2025/with/free-livestream" target="_blank" rel="nofollow noopener noreferrer" translate="no">https://ti.to/writethedocs/write-the-docs-portland-2025/with/free-livestream</a>Can’t make it? Join the final virtual discussion with Jodie Landes on April 1st at 12:00 pm PST.<a href="https://fosstodon.org/tags/WTDPortland2025" class="mention hashtag" rel="tag">#WTDPortland2025</a> <a href="https://fosstodon.org/tags/writethedocs" class="mention hashtag" rel="tag">#writethedocs</a>

Write the DocsWhat happens when your documentation is public, and anyone can contribute? 🌍Colin Loretz will share how Discord's developer docs aren’t just written for the community—they're written with the community. By opening up documentation to public contributions, Discord has created a collaborative ecosystem that improves accuracy, speeds up updates, and fosters a sense of ownership among developers.Learn more: <a href="https://www.writethedocs.org/conf/portland/2025/speakers/#speaker-colin-loretz-open-docs-open-collaboration-building-better-documentation-with-community-prs-colin-loretz" target="_blank" rel="nofollow noopener noreferrer" translate="no">https://www.writethedocs.org/conf/portland/2025/speakers/#speaker-colin-loretz-open-docs-open-collaboration-building-better-documentation-with-community-prs-colin-loretz</a><a href="https://fosstodon.org/tags/writethedocs" class="mention hashtag" rel="tag">#writethedocs</a>

Write the DocsToday’s virtual “Docs in Discussion: Speaker Series” discussion is at 12:00 pm PST with speaker Stephanie Fuller and host Joe Meersman! Join fellow documentarians and get a view into Stephanie’s talk, experience, and why she’s excited about the conference. Can’t make this one? Join us next week on March 24th, at the same time.Register for the free virtual discussions at <a href="https://ti.to/writethedocs/write-the-docs-portland-2025/with/free-livestream" target="_blank" rel="nofollow noopener noreferrer" translate="no">https://ti.to/writethedocs/write-the-docs-portland-2025/with/free-livestream</a>. This ticket gives you access to all three discussions.<a href="https://fosstodon.org/tags/writethedocs" class="mention hashtag" rel="tag">#writethedocs</a> <a href="https://fosstodon.org/tags/WTDPortland2025" class="mention hashtag" rel="tag">#WTDPortland2025</a>

Write the DocsRelying solely on doc metrics and sporadic customer feedback fails to provide a full picture of how to improve your documentation. Yanjie Nieu will identify a framework for support and documentation teams to establish a collaborative rhythm and find actionable strategies to transform your documentation process.Learn more: <a href="https://www.writethedocs.org/conf/portland/2025/speakers/#speaker-yanjie-niu-the-power-of-two-how-support-and-documentation-teams-transform-technical-conten-yanjie-niu" target="_blank" rel="nofollow noopener noreferrer" translate="no">https://www.writethedocs.org/conf/portland/2025/speakers/#speaker-yanjie-niu-the-power-of-two-how-support-and-documentation-teams-transform-technical-conten-yanjie-niu</a><a href="https://fosstodon.org/tags/writethedocs" class="mention hashtag" rel="tag">#writethedocs</a>

Yvonne PerkinsThis article about 'invalidating management styles' really resonates with me as I recently have had a year where any initiative that I showed (and there were many) was met by a manager who said ' that is not what we need' or 'our engineers won't like that' or the other myriad problems he can find with my initiative. The worst response was 'there's too much of you in it' (translation: they don't want me to present, but he can present).I ended up being out of ideas and miserable. All along I was networking within the organisation and found a secondment with another team. On the 1st morning a depressing weight lifted off my shoulders. I never expect perfection in others, but I love this team and its managers. We even have lunch together at least once a week because we enjoy each other's company . <a href="https://aus.social/tags/TechnicalWriting" class="mention hashtag" rel="nofollow noopener noreferrer" target="_blank">#TechnicalWriting</a> <a href="https://aus.social/tags/WriteTheDocs" class="mention hashtag" rel="nofollow noopener noreferrer" target="_blank">#WriteTheDocs</a> <a href="https://www.theguardian.com/commentisfree/2025/mar/16/a-managers-flat-response-to-gails-initiative-left-her-deflated-feeling-seen-is-fundamental-to-human-wellbeing" rel="nofollow noopener noreferrer" translate="no" target="_blank">https://www.theguardian.com/commentisfree/2025/mar/16/a-managers-flat-response-to-gails-initiative-left-her-deflated-feeling-seen-is-fundamental-to-human-wellbeing</a>

Recent searches

Search options

Administered by:

Server stats:

#writethedocs