#writeTheDocs

Dysmorphia💛🤍💜🖤dys_morphia@sfba.social
2025-05-23

Haunted manuals lightning talk

I gave a lightning #WriteTheDocs in Portland, and in this post I share the recording and my slide deck.

rinsemiddlebliss.com/posts/202

#TechnicalWriting

Just 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!

bit.ly/4j2rW2D

#UXWriting #WriteTheDocs #DesignSystems

Dysmorphia💛🤍💜🖤dys_morphia@sfba.social
2025-05-06

I impulsively signed up for a lightning talk at #WriteTheDocs 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. rinsemiddlebliss.com/posts/202

MissStenoMissSteno
2025-05-06

Day 2 of providing live captioning at . @whitecoatcaptioning

MissStenoMissSteno
2025-05-05

So excited to be captioning for the 7th year in a row! 🥳 @whitecoatcaptioning @writethedocs

2025-05-05

Doors are officially open here at our Portland #WriteTheDocs 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 Silva

More resources can be found on our Attendee Guide: writethedocs.org/conf/portland #WTDPortland2025

rain trutherschratze@todon.nl
2025-05-05

Anyone attending the #WriteTheDocs online conference today? (today for me, tomorrow for some of you)

Brian MacDonaldbmac@jawns.club
2025-05-04

Hike in Portland with #WriteTheDocs on Saturday. This view from Pittock Mansion ain't half bad. Glad we had a nice day for it.

A long distance photo of the Portland skyline taken from Pittock Mansion. I'm the foreground are thick green trees on a downward slope. I'm the middle ground is the skyline of Portland, with a few skyscrapers and a variety of small buildings. In the distance is a line of mountains, although Mount Hood is obscured by clouds. All of this is under a bluish grey sky of puffy clouds.
Brian MacDonaldbmac@jawns.club
2025-05-01

I'm heading to #WriteTheDocs 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?

2025-04-28

📝 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.

writethedocs.org/conf/portland

#writethedocs

Dysmorphia💛🤍💜🖤dys_morphia@sfba.social
2025-04-26

I managed to wrangle the budget to fund me and 2 other writers on my team to come to #WriteTheDocs 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.

2025-04-23

It’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: writethedocs.org/conf/portland

You’ll be in great company.

#WriteTheDocs #CollaborativeWriting #OpenSourceDocs

Daniel D. Beckddbeck
2025-04-22

I 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. youtube.com/watch?v=lmwpPyrrPdY

I took some longer notes here: ddbeck.com/notes/diminishing-c

2025-04-21

Swing 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: writethedocs.org/conf/portland

#writethedocs

2025-04-20

Ever wondered how beforeEach works in unit test frameworks? Check out our new lifecycle diagram!

qunitjs.com/lifecycle/

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 @FND @simulo @nullvoxpopuli

#qunit #WriteTheDocs #TechnicalWriting #SoftwareDocumentation #documentation #TDD

Imagine a test with global hooks, and a Parent and Child module that use hooks also. The execution order is:
1. Parent module runs the before hook.
2. Every test in the Parent module inherits context from the before hook, and repeats as follows: call global beforeEach, parent beforeEach, the actual test, parent afterEach, and lastly the global afterEach.
3. The Child module inherits context from the Parent before hook, and then runs its own before hook.
4. Every test in the Child module inherits context from this before hook, and repeats as follows: call global beforeEach, parent beforeEach, child beforeEach, the actual test, child afterEach, parent afterEach, and lastly the global afterEach.
2025-04-18

We’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: writethedocs.org/conf/portland

#writethedocs

2025-04-17

We 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: writethedocs.org/conf/portland

#writethedocs

indie on infosec exchangeindie@infosec.exchange
2025-04-17

A pic I took from the top of #Revolution Hall, at the #WriteTheDocs #Portland conference last year.

Until today, I've remained publicly silent about my attendance at this conference because ... all in all, it was a major letdown.

Here (and here) I'll tell you why.

Conference started off well enough. A self-proclaimed "extrovert" got up on stage and vomited some baloney-and-white bread about how she was there to represent #Nginx. And that Nginx was there for no other reason than to have her be their representative, from what I recall of her stage presentation.

"I'm an extrovert, if you don't know who to talk to, come talk to me" she said.

Days go by, and all of the conference is very narrow on like, a very narrow slice of technology-related things, I felt it was lacking some broader perspectives of what my career -- Technical Writing -- was all about.

And I did not plan to give a lightning talk, but when I woke up the last day of the conference again thinking about how there had been way too much conflation of the words "technology" and "technical", I wanted to speak up for my career.

The conference was making the #DigitalDivide much much bigger and wider, which is not what conferences are supposed to do. Thus, I did not ignore my pressing intuition that I should attempt to speak up for the young talent present -- maybe not in these "exact" words, but you get the gist of the idea:

NO, you don't need a god-damn Macbook to be a technical writer... not all technical writing is about computer-related things.

A lightning talk is short, very brief overview and allowing a speaker to introduce their area of expertise.

So while the conference organizers thought this was A-OK for the white supremacist, Nginx "extrovert" to tell people to come talk to her, it was NOT OKAY for someone whose ancestors were there first?

Yeah, that snooty white supremacist who was put "in charge" of the conference talks did what white supremacists do,

âś… pretended like I don't exist,
âś… communicated how much more "important" her extroversion is than my idea for a talk
âś… that I should not have been there and should "go away"

After the talk was rejected, I approached her and asked to retrieve the document I'd prepared asking to give a lightning talk. A copy of that that Lightning Talk Submission document is included on this server.

🌩️ ⚡

"I'm #auditing for the documentation trail of my #documentation I told her.

She looked startled, hum-hawed for a bit, evaded direct answer, and I could see panic in her eyeballs behind her glasses. When she finally came up with the answer that she thought would make me go away.

She told me it was shredded.

LOL, she just happened to find the shredder in that huge building and dispose of all evidence?

Within 3 minutes of being rejected, she told me she'd shredded all the lightning talk submission papers.

SUCH A #LIAR.

And I told her: "Oh, good thing I took a picture of it".

*10 years before the year of this story, I was an approved speaker (not a Lightning talk but a full-fledged conference talk) at WTD Portland.

A gorgeously-designed picnic table of sold stained to be reddish wood on the outdoor balcony of Revolution HallLeona's attempt to help conference attendees learn about other genres of Technical Writing was communicated on this sheet of paper that eventually got shredded by an angry white supremacist somebody put in charge of the conference talks. 

" Lightning Talk Signup Form"

Name:  Leona
Pronouns:  she/her
WTD Slack Handle:  "I don't like Salesforce"  :(

....

other words

Ecosteader logo bird on picture as watermark.Snapshot of the Canadian Encyclopedia that discusses the 0001 -  1490 years of the RCT calendar. A Mi'kmaq descendant has added a layer with jipji'ju'gisutnat and some additional text:  "Mi'kmaq exited on what is now the North American Continent before Columbus got here"
2025-04-17

A pic I took on the streets of #Portland
# 363 days ago, area within walking distance of #Revolution Hall.

I've remained publicly silent on my #WriteTheDocs 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 #Nginx.

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 #censoring the indigenous voice that wanted to get on stage and tell everybody that not all #TechnicalWriting has to be about #technology.

That snooty white supremacist bitch who was "in charge" of the conference talks rejected this talk.

After the talk was rejected, I asked to retreive this document, as I told her I was auditing the documentation trail....

She hum-hawed for a bit, evaded direct answer, and I could see panic in eyeballs behind her glasses when she finally came up with the answer that she thought would make me go away.

She told me it was shredded. LOL, she just happened to find the shredder in that building and dispose of all evidence.

Within 3 minutes of being rejected, she told me she shredded all the lightning talk submission papers.

SUCH A #LIAR.

And I told her: "Oh, good thing I took a picture of it".

In 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 documentation

Let me know if you have any questions, and please share far and wide!

#DesignSystems #WriteTheDocs

Client Info

Server: https://mastodon.social
Version: 2025.04
Repository: https://github.com/cyevgeniy/lmst