Elizabeth Tai :verified: · @liztai
3107 followers · 9604 posts · Server hachyderm.io

Maybe my brain can't cope but why the heck is it so hard to navigate omg

Me trying to interpret user journeys through Figma designs: 👇

#writer #figma #tech #technicalwriting

Last updated 1 year ago

David Bureš · @davidbures
563 followers · 1234 posts · Server mstdn.social

Through my technical writing career, I have discovered that if I ever want to switch careers, I should go into QA.

It’s ridiculous how many bugs I discover while writing manuals that our QA had no idea about!

#technicalwriting

Last updated 1 year ago

Gianluca Fiore · @gianlucafiore
25 followers · 157 posts · Server metalhead.club

I have been meeting with a discouraging series of low salary offers. Not that I am looking for work, just regularly getting hit by recruiters.
Barely 2000€ (net) for senior roles is next to outrageous. And from firms in wealthy nations even.

#technicalwriting

Last updated 1 year ago

hankuoffroad :fedora: · @hankuoffroad
39 followers · 15 posts · Server floss.social

@fedora

The Fedora Docs team will host virtual writing workshop.

We will kick off with introduction and onboarding.
– What the Docs team is all about. What role will interest you?
– The types of user documentation Fedora Linux publishes
– How you can help improve Fedora Documentation

If you fancy coming along, just let us know your preferred timeslot in the When-is-good scheduler by September 15 2023.

fedoramagazine.org/docs-worksh

whenisgood.net/qrnxqwp

#FLOSS #technicalwriting #OpenSource

Last updated 1 year ago

David Bureš · @davidbures
561 followers · 1200 posts · Server mstdn.social

I’ve been hard at work writing Cork’s built-in Help book. I got the structure and the first couple chapters done already! This is what I do for a living, after all 😂

To all the macOS developers who had to write Help books: do you have any tips? What did you use to write the book? I've been using Typora and then converting the folder to HTML using github.com/joakin/markdown-fol, but I wonder if there's a better way

#corkapp #homebrew #macdev #buildinpublic #OpenSource #macOS #technicalwriting

Last updated 1 year ago

Dysmorphia💛🤍💜🖤 · @dys_morphia
251 followers · 891 posts · Server sfba.social

I wrote more about haunted manuals. Part 1 defined the terms. Part 2 gave counterexamples. Now, at last, here come examples.

A taxonomy of old haunted manuals
Your manual is haunted. But how, exactly? (Haunted manuals part 3)

rinsemiddlebliss.com/posts/202

#technicalwriting #hauntology #Derrida #documentation #hauntedmanuals

Last updated 1 year ago

erin · @urn
56 followers · 27 posts · Server social.lol

Have reached the point where I bemoan gdocs for its lack of markdown support, slash commands, and command palette nav every time I open one.

I know I live pretty far down the docs as code / PKM rabbit hole, but I sincerely hope some of these design cues make it to the big time.

#technicalwriting #obsidian

Last updated 1 year ago

Dysmorphia💛🤍💜🖤 · @dys_morphia
251 followers · 877 posts · Server sfba.social

This week I continue the haunted manuals series with a bit of a swerve into old circuit diagram appreciation.

Elegant diagrams (not haunted)
Haunted manuals, part 2, being a digression through circuit diagrams

rinsemiddlebliss.com/posts/202

#circuitdiagram #technicalwriting #blog

Last updated 1 year ago

Phil Davis · @rekiwi
211 followers · 1942 posts · Server mastodon.nz

Me: [pushing long established process] Anything for this release?
*crickets*
Me: Anything at all? Nothing's flagged In Jira.
*crickets*
Me: OK. I'm cancelling tomorrow's global meeting.
Folks: [next morning] Wow, Phil. We missed all your emails & DMs. We've actually got a lot to talk about. Can you drop everything & work like mad to produce these release notes & run a meeting like your standing meeting but on a random day/time ASAP?
Me: …

#techWriterLife #technicalwriting

Last updated 1 year ago

Phil Davis · @rekiwi
211 followers · 1942 posts · Server mastodon.nz

Docs as code: More like docs IN code. Learning about swagger.annotations while advocating for upgrade to support OpenAPI v3. It's been a while since I worked in Java. Weird to get nostalgia vibes on a current project. Also I feel like the teacher learning the subject the night before the class. Damn I love this job.

#techWriterLife #technicalwriting #writethedocs #docsascode

Last updated 1 year ago

David Bureš · @davidbures
554 followers · 1119 posts · Server mstdn.social

Hands-down, the most useful part of ChatGPT is translating the borderline incomprehensible English from our JIRA issues, written by SMEs who barely speak English, into something that I can actually read.

For this, I use a Raycast AI command with a pretty short prompt.

Works like a charm about 95% of the time.

@rekiwi

#technicalwriting #GPT4 #chatgpt #AI #raycast

Last updated 1 year ago

Phil Davis · @rekiwi
210 followers · 1933 posts · Server mastodon.nz

@djwfyi Yesterday we were Cassandra. Today you can just call us Sisyphus.

#techWriterLife #technicalwriting

Last updated 1 year ago

Dachary · @dachary
164 followers · 439 posts · Server dacharycarey.social

I am in the middle of a gap analysis audit this week, and oof it is a slog. We don’t have tooling around this so I’m doing it manually. Auditing 6 SDK docs sets just takes time.

I start with a page-level audit to identify missing pages, and then a section-level audit to identify missing info on existing pages, and then create Jira tix to fill the gaps.

We should do this annually, but so far we’ve just done it ad hoc for single SDKs. Curious how it goes.

#documentation #technicalwriting

Last updated 1 year ago

Phil Davis · @rekiwi
210 followers · 1924 posts · Server mastodon.nz

@trike You can just call us Cassandra.

#techWriterLife #technicalwriting

Last updated 1 year ago

Dachary · @dachary
164 followers · 437 posts · Server dacharycarey.social

@dgarcia360 I was just discussing this recently with some teammates. Our conclusion was to use lists for data with one or maybe two dimensions, and reserve tables for data with three or more dimensions. Our rationale was that tables create heavier styling on the page, and more overhead for screen readers, and should be reserved for data that warrants it. Always interesting to hear different opinions from other folks in the community.

#technicalwriting

Last updated 1 year ago

Dysmorphia💛🤍💜🖤 · @dys_morphia
250 followers · 858 posts · Server sfba.social

Haunted manuals

You've heard of the curse of knowledge, but could your manual be haunted as well?

How might a manual be haunted? Wait, what is the curse of knowledge? What the heck is hauntology? I answer those questions and give a few preliminary examples of haunted manuals.

rinsemiddlebliss.com/posts/202

#technicalwriting #hauntology #Derrida #documentation #blog #blogging

Last updated 1 year ago

Mystile · @Mystile
66 followers · 471 posts · Server mastodonbooks.net

So I'm taking Thursday and Friday off because of how fatigued I feel. I foresee this becoming a regular occurrence until I can find my way to another job because the Autistic burnout is getting stronger.

I wish I could find a mentor, especially for something like technical and/or UX writing. It seems everybody I reach out to is also burnt out.

@actuallyautistic

#actuallyautistic #autisticburnout #mentorship #mentor #technicalwriting #uxwriting

Last updated 1 year ago

Phil Davis · @rekiwi
211 followers · 1887 posts · Server mastodon.nz

@apfelkraut @darktable RTFM reminds me of Erin Grace, a force for good in the docs/user-ed space and her helpful, empathetic, practical reimagining/redefinition of "RTFM": readthefriendlymanual.com/blog

#techWriterLife #technicalwriting #writethedocs

Last updated 1 year ago

Phil Davis · @rekiwi
208 followers · 1859 posts · Server mastodon.nz

Silver lining on a stupid cloud: I posted recently about my bad call when structuring doc sets. The good news: my years of work to maintain consistency across projects is really paying off as I chop & hack & reshuffle & extend (variable names, conditional tags, file organization, etc.)

#techWriterLife #technicalwriting #writethedocs

Last updated 1 year ago

Phil Davis · @rekiwi
208 followers · 1859 posts · Server mastodon.nz

The Brave Little Tech Writer

#techWriterLife #technicalwriting

Last updated 1 year ago