TechHub

DarylWait, you mean you're supposed to resolve the merge conflicts BEFORE publishing the docs?Huh.<a href="https://vmst.io/tags/git" class="mention hashtag" rel="nofollow noopener" target="_blank">#git</a> <a href="https://vmst.io/tags/wtd" class="mention hashtag" rel="nofollow noopener" target="_blank">#wtd</a> <a href="https://vmst.io/tags/writeTheDocs" class="mention hashtag" rel="nofollow noopener" target="_blank">#writeTheDocs</a> <a href="https://vmst.io/tags/documentation" class="mention hashtag" rel="nofollow noopener" target="_blank">#documentation</a>

Marcin SJ :blobfoxfingerguns:I spent the last few days setting up a new mini PC for a home lab and Home Assistant OS in a VM.All the HA stuff is pretty new to me, so I've had to learn a fair amount of new concepts and terms.As a tech writer, I've become allergic to word like "simply" and "just [do X]" in the docs. And one of those sentences gave me a lot of head scratching in the Valetudo MQTT + Home Assistant integration[1]. Saved by a YouToube tutorial.On the other hand, I loved (and succeeded) following Brian's readme for the xkcd card integration[2]. [1] <a href="https://valetudo.cloud/pages/integrations/home-assistant-integration.html" rel="nofollow noopener" translate="no" target="_blank">https://valetudo.cloud/pages/integrations/home-assistant-integration.html</a> [2] <a href="https://github.com/Brianfit/xkcd-card-ha" rel="nofollow noopener" translate="no" target="_blank">https://github.com/Brianfit/xkcd-card-ha</a><a href="https://mastodon.social/@brianfit" class="u-url mention" rel="nofollow noopener" target="_blank">@brianfit</a> <a href="https://hachyderm.io/tags/HomeAssistant" class="mention hashtag" rel="nofollow noopener" target="_blank">#HomeAssistant</a> <a href="https://hachyderm.io/tags/Valetudo" class="mention hashtag" rel="nofollow noopener" target="_blank">#Valetudo</a> <a href="https://hachyderm.io/tags/xkcd" class="mention hashtag" rel="nofollow noopener" target="_blank">#xkcd</a> <a href="https://hachyderm.io/tags/WriteTheDocs" class="mention hashtag" rel="nofollow noopener" target="_blank">#WriteTheDocs</a>

Dysmorphia💛🤍💜🖤Haunted manuals lightning talkI gave a lightning <a href="https://sfba.social/tags/WriteTheDocs" class="mention hashtag" rel="nofollow noopener" target="_blank">#WriteTheDocs</a> in Portland, and in this post I share the recording and my slide deck.<a href="https://rinsemiddlebliss.com/posts/2025-05-16-haunted-manuals/" rel="nofollow noopener" translate="no" target="_blank">https://rinsemiddlebliss.com/posts/2025-05-16-haunted-manuals/</a><a href="https://sfba.social/tags/TechnicalWriting" class="mention hashtag" rel="nofollow noopener" target="_blank">#TechnicalWriting</a>

Amy HupeJust a couple of tickets left now for my Writing design systems documentation session at 10am-1pm next Thursday, 29 May.If you're available and want to learn how to create docs people can find, understand and use, I'd love to have you.Tell your friends!<a href="https://bit.ly/4j2rW2D" rel="nofollow noopener" translate="no" target="_blank">https://bit.ly/4j2rW2D</a><a href="https://social.design.systems/tags/UXWriting" class="mention hashtag" rel="nofollow noopener" target="_blank">#UXWriting</a> <a href="https://social.design.systems/tags/WriteTheDocs" class="mention hashtag" rel="nofollow noopener" target="_blank">#WriteTheDocs</a> <a href="https://social.design.systems/tags/DesignSystems" class="mention hashtag" rel="nofollow noopener" target="_blank">#DesignSystems</a>

Dysmorphia💛🤍💜🖤I impulsively signed up for a lightning talk at <a href="https://sfba.social/tags/WriteTheDocs" class="mention hashtag" rel="nofollow noopener" target="_blank">#WriteTheDocs</a> today. To my surprise, I got chosen and so prepared a 5 minute version of my Haunted Manuals series over lunch and presented it. I had a lot of fun! Maybe I’ll actually finish the blog post series this year. <a href="https://rinsemiddlebliss.com/posts/2023-08-11-haunted-manuals/" rel="nofollow noopener" translate="no" target="_blank">https://rinsemiddlebliss.com/posts/2023-08-11-haunted-manuals/</a>

MissStenoDay 2 of providing live captioning at <a href="https://mastodon.social/tags/writethedocs" class="mention hashtag" rel="nofollow noopener" target="_blank">#writethedocs</a>. <a href="https://mastodon.social/tags/wtd" class="mention hashtag" rel="nofollow noopener" target="_blank">#wtd</a> <a href="https://mastodon.social/@whitecoatcaptioning" class="u-url mention" rel="nofollow noopener" target="_blank">@whitecoatcaptioning</a>

MissStenoSo excited to be captioning <a href="https://mastodon.social/tags/writethedocs" class="mention hashtag" rel="nofollow noopener" target="_blank">#writethedocs</a> for the 7th year in a row! 🥳 <a href="https://mastodon.social/@whitecoatcaptioning" class="u-url mention" rel="nofollow noopener" target="_blank">@whitecoatcaptioning</a> <a href="https://fosstodon.org/@writethedocs" class="u-url mention" rel="nofollow noopener" target="_blank">@writethedocs</a>

Write the DocsDoors are officially open here at our Portland <a href="https://fosstodon.org/tags/WriteTheDocs" class="mention hashtag" rel="nofollow noopener" target="_blank">#WriteTheDocs</a> conference! 🎉 Get ready for two days of insightful talks, collaboration, and connection. Individual talks are followed by 10 minutes of Q&A, so bring your curiosity and your questions! Today’s speakers: Rachel Rigdon, Yanjie Niu, Holly Mickelson, Stephanie Fuller, Janine Chan, Ravind Kumar, Manny SilvaMore resources can be found on our Attendee Guide: <a href="https://www.writethedocs.org/conf/portland/2025/attendee-guide/" rel="nofollow noopener" translate="no" target="_blank">https://www.writethedocs.org/conf/portland/2025/attendee-guide/</a> <a href="https://fosstodon.org/tags/WTDPortland2025" class="mention hashtag" rel="nofollow noopener" target="_blank">#WTDPortland2025</a>

vitamin schratzeAnyone attending the <a href="https://todon.nl/tags/WriteTheDocs" class="mention hashtag" rel="nofollow noopener" target="_blank">#WriteTheDocs</a> online conference today? (today for me, tomorrow for some of you)

Brian MacDonaldHike in Portland with <a href="https://jawns.club/tags/WriteTheDocs" class="mention hashtag" rel="nofollow noopener" target="_blank">#WriteTheDocs</a> on Saturday. This view from Pittock Mansion ain't half bad. Glad we had a nice day for it.

Brian MacDonaldI'm heading to <a href="https://jawns.club/tags/WriteTheDocs" class="mention hashtag" rel="nofollow noopener" target="_blank">#WriteTheDocs</a> tomorrow, and I'm starting to get excited! Had to skip last year for Reasons, but I'm back and better than ever! I'm planning to do the Writing Day, the Hike, the whole enchilada. Who else is going?

Write the Docs📝 Getting ready for this week’s Portland conference, and have a question? We may have just answered it in our News! Head to the link below for the FAQ scoop including how to participate, important links, and more. We’re also excited to announce that we’re opening up our Monday Unconference schedule and are accepting Lightning Talk submissions beginning today. <a href="https://www.writethedocs.org/conf/portland/2025/news/welcome-portland-2025/" rel="nofollow noopener" translate="no" target="_blank">https://www.writethedocs.org/conf/portland/2025/news/welcome-portland-2025/</a><a href="https://fosstodon.org/tags/writethedocs" class="mention hashtag" rel="nofollow noopener" target="_blank">#writethedocs</a>

Dysmorphia💛🤍💜🖤I managed to wrangle the budget to fund me and 2 other writers on my team to come to <a href="https://sfba.social/tags/WriteTheDocs" class="mention hashtag" rel="nofollow noopener" target="_blank">#WriteTheDocs</a> in Portland in person and we are all very hyped. It’s my second time attending in person (I think? Lots online. Time is a blur), but the first for the other two.

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/" rel="nofollow noopener" translate="no" target="_blank">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="nofollow noopener" target="_blank">#WriteTheDocs</a> <a href="https://fosstodon.org/tags/CollaborativeWriting" class="mention hashtag" rel="nofollow noopener" target="_blank">#CollaborativeWriting</a> <a href="https://fosstodon.org/tags/OpenSourceDocs" class="mention hashtag" rel="nofollow noopener" target="_blank">#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" 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" translate="no" target="_blank">https://ddbeck.com/notes/diminishing-content/</a> <a href="https://mastodon.social/tags/WriteTheDocs" class="mention hashtag" rel="nofollow noopener" 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/" rel="nofollow noopener" translate="no" target="_blank">https://www.writethedocs.org/conf/portland/2025/</a><a href="https://fosstodon.org/tags/writethedocs" class="mention hashtag" rel="nofollow noopener" target="_blank">#writethedocs</a>

QUnitEver wondered how beforeEach works in unit test frameworks? Check out our new lifecycle diagram!<a href="https://qunitjs.com/lifecycle/" rel="nofollow noopener" translate="no" target="_blank">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" rel="nofollow noopener" target="_blank">@FND</a> <a href="https://hci.social/@simulo" class="u-url mention" rel="nofollow noopener" target="_blank">@simulo</a> <a href="https://mastodon.coffee/@nullvoxpopuli" class="u-url mention" rel="nofollow noopener" target="_blank">@nullvoxpopuli</a> <a href="https://fosstodon.org/tags/qunit" class="mention hashtag" rel="nofollow noopener" target="_blank">#qunit</a> <a href="https://fosstodon.org/tags/WriteTheDocs" class="mention hashtag" rel="nofollow noopener" target="_blank">#WriteTheDocs</a> <a href="https://fosstodon.org/tags/TechnicalWriting" class="mention hashtag" rel="nofollow noopener" target="_blank">#TechnicalWriting</a> <a href="https://fosstodon.org/tags/SoftwareDocumentation" class="mention hashtag" rel="nofollow noopener" target="_blank">#SoftwareDocumentation</a> <a href="https://fosstodon.org/tags/documentation" class="mention hashtag" rel="nofollow noopener" target="_blank">#documentation</a> <a href="https://fosstodon.org/tags/TDD" class="mention hashtag" rel="nofollow noopener" target="_blank">#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/" rel="nofollow noopener" translate="no" target="_blank">https://www.writethedocs.org/conf/portland/2025/</a><a href="https://fosstodon.org/tags/writethedocs" class="mention hashtag" rel="nofollow noopener" target="_blank">#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/" rel="nofollow noopener" translate="no" target="_blank">https://www.writethedocs.org/conf/portland/2025/</a><a href="https://fosstodon.org/tags/writethedocs" class="mention hashtag" rel="nofollow noopener" target="_blank">#writethedocs</a>

indieA pic I took on the streets of <a href="https://kolektiva.social/tags/Portland" class="mention hashtag" rel="nofollow noopener" 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" 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" 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" 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" 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" target="_blank">#TechnicalWriting</a> has to be about <a href="https://kolektiva.social/tags/technology" class="mention hashtag" rel="nofollow noopener" target="_blank">#technology</a>. But that snooty white supremacist bitch rejected this talk.

Recent searches

Search options

Administered by:

Server stats:

#writethedocs