#TechComm

ricksapirricksapir
2025-05-05

The problem with "feature first"

\\From Beta to Bedrock: Build Products that Stick.

alistapart.com/article/from-be

(Liam Nugent via A list apart)

ricksapirricksapir
2025-05-01

Is "intelligence type" missing from your personas?

\\The Many Facets of Intelligence: Designing User Experiences and Documentation for Diverse Minds

uxmatters.com/mt/archives/2025

(@samiksha Chaudhuri via @uxmatters)

DeFrEnT Christopher KöbelDeFrEnTck@hessen.social
2025-04-05

Wieso finde ich auf tekom.de/services-unsere-angeb keinen prominenten Link auf
technischekommunikation.info/ sondern erfahre erst durch eine Suchmaschine, dass es die Zeitschrift auch digital zu lesen gibt? :det_surprised:
#techcomm #tekom

2025-03-07

When I was working at the Toronto Stock Exchange I had to create some large documents with content that was being shared with another writer. I did not trust Word's Master Document feature so came up with my own solution. It took a bit more effort than using Master Documents but was stable. I've published my guide to working with multi-file Word documents on my blog in the hope that it may help others.

coredump3.blogspot.com/2025/03

#MicrosoftWord #word365 #TechComm #TechnicalWriting

DJ Fragile Toolchainsplaindocs@chaos.social
2025-02-18

Another day in the life of a documentarian. #writethedocs #techcomm

An absolute mess of tangled telephone wires.
2025-01-29

If you're a technical writer, today is a sad day. The Society for Technical Communication has filed for bankruptcy.

coredump3.blogspot.com/2025/01

#TechComm #STC

@alanpringle @sarahokeefe

Scott P ✅saprentice
2025-01-29

Wow. After some 60+ years the Society for Technical Communication (STC) has folded. I’ve been a member for more than 20 years.

This is a reflection on the importance (or lack thereof) of documentation particularly in the software industry, but also hardware, manufacturing, etc. This was once seen as crucial for customer support, but now it’s just an expense to spend as little on as possible.

stc.org/

2025-01-20

Since I joined Mastodon in 2022, I haven't taken the time to write an #introduction. With #HelloQuitX and the current shitshow, now is probably a good time !

I'm a linguist & painter who found a calling working on digital information architecture. With age, I'm turning into an ecofeminist witch.

I've been practicing #yoga & #meditation for 20 years, trained as a teacher but I'm weary of new-age bullshit being a cover for capitalism investing our bodies. So I teach #TechComm instead.

1/2

Ivana Isadora Devcicivana@mastodon.xyz
2025-01-17

📅💊 Highlights of the work day:

- Reviewed a big PR with significant content updates + a new guide that should clarify an important concept and help users establish some best practices when using the products

- Great Q&A session with the product manager as part of the kickoff meeting for a new docs project

- Spent some time troubleshooting the GH Action from yesterday; still reconsidering the current approach

#MyMicroBlog #TechnicalWriting #techcomm #documentation

Ivana Isadora Devcicivana@mastodon.xyz
2025-01-16

📅 😷 Highlights of the work day:

- Worked on automating the process of creating release notes with GitHub Actions

- Updated the plan and prepared action items for a new documentation project

- Reviewed updates to an OpenAPI document. Figuring out the best approach for using a schema as a base, extensible model

#MyMicroBlog #TechnicalWriting #techcomm #documentation

Miguel Afonso Caetanoremixtures@tldr.nettime.org
2025-01-07

"Similar to Wood’s conviction that AI’s transformative potential doesn’t come from simple tasks like writing emails, tech writers will likely find conviction when they go beyond fixing simple grammar errors to using AI for developing conceptual articles, generating release notes, or understanding connections across disparate API products.

One of my colleagues compared using AI like learning to play an instrument—it’s one thing to have an intellectual understanding about the instrument and notes, but knowing how to play an instrument well is entirely different. It takes practice, experimentation, learning, diligence, and time. Maybe too many tech writers feel that AI should provide a push-button solution to creating documentation effortlessly (a misguided perception based on too much AI hype). When pushing that button doesn’t magically produce great docs, perhaps they become cynical and dismissive?"

idratherbewriting.com/blog/tre

#AI #GenerativeAI #TechnicalWriting #TechnicalCommunication #APIs #APIDocumentation #PromptEngineering #TechComm

DJ Fragile Toolchainsplaindocs@chaos.social
2025-01-06

Only a couple of weeks left to get your documentation related talk proposal in for the next Write the Docs conference, held May 4-6 Portland.

➡️ writethedocs.org/conf/portland

#writethedocs #techcomm #documentation #cfp

2024-12-11

Work today has been filled with so many questionable, last minute changes. For example, I was asked to add the following to some user instructions:

"The end user must take suitable precautions to prevent exposure to chemicals which may damage the materials used in the construction of this component."

I pushed back against this for being too vague. "Chemicals" could literally be anything and everything so some examples should be provided. And the responsible engineer still could not see the issue with providing the reader with inadequate information.

#TechnicalCommunication #TechComm #TechnicalWriting

2024-12-05

There are times that I think that I've inadvertently entered "The Place That Drives You Mad" from the film, The Twelve Tasks of Asterix...

I got asked to add a "hose loop" to a document. After checking, it appears that the item is sold with a description of, "hose clip". To add insult to injury, the official name of the item according to the company terminology dictionary is, "hose retaining flap".

#TechnicalCommunication #TechComm #TechnicalWriting #Terminology

2024-11-16

I was searching through my company's Confluence space yesterday and stumbled upon this page titled "Technical writing explained" and this was the entirety of the content that was on the page.

Part of me was incredulous. Like, how dare they reduce my entire field in this over-simplistic way! And another part of me was like, eh, they're not _entirely_ wrong.

Title of the page: Technical writing explained
Author and org blurred out
Page content: 
Technical writing is different from creative writing because it
- Is factual
- Meets a need
- Can be used by different audiences
- Written in clear, unambiguous, unemotional language

and that was it. that was the whole page.
Ben Bristowkrib
2024-09-17

I explain what I do in descending order of specificity, situation-dependent:

- I write UI and API docs for a cybersecurity company.

- I’m a software tech writer.

- I’m a “tech writer.” I write software manuals. No, not furniture manuals.

- I work in tech. No, I’m not a programmer, but I know some. They’re nice. Sometimes.

- I work in tech.

- I work with computers.

The attached Calkearns (with alt-text) is better for some of these.

Two people at a social event ask a man who looks exactly like John Locke from Lost what he does for work. He answers, “It’s complicated.” The second frame shows what he does, and he’s correct. He’s a surgical assistant at a mouse hospital/pizzeria. He does need to wear a uniform, which includes a mouse hat and pants with a tail. One assumes this is their equivalent of business casual. He probably doesn’t get work-from-home days, since this role wouldn’t translate well to Zoom.
DeFrEnT Christopher KöbelDeFrEnTck@hessen.social
2024-08-30

Hi technical communicators and editors/translators in technical documentation, I'd like to point you towards an open TC textbook that I've been made aware of: digitalcommons.kennesaw.edu/op (free PDF or available in print for small money - in the US). It's CC-BY licensed, too!

#techdoc #techcomm #xl8 #cpd #creativecommons #commons

2024-06-25

Strange O/S message: "Your computer ran into a success."

infosec.exchange/@catsalad/112

Larry SwansonLarrySwanson
2024-06-24

Twenty years ago at IBM, the company's commitment to user-focused content led to the decision to develop a standard way of structuring content for multiple channels. Michael Priestley led the effort to create the new standard that became . A fascinating journey down Memory Lane in this conversation.

ellessmedia.com/csi/michael-pr

2024-05-16

At the annual STC Summit in Minneapolis. Go ! But sadly no Mastadon posts for that I can find (that relate to tech comm, anyway).

Where are my fellow fediverse TC peeps?

John travolta in pulp fiction, looking around in a bewildered manner.

Client Info

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