@remoquete@hachyderm.io
@remoquete@hachyderm.io avatar

remoquete

@remoquete@hachyderm.io

Principal Technical Writer at @Splunk. OpenTelemetry.io docs approver. I write to live, and live to read. Italian. Father of three. Collector of old manuals. Retrocomputing enthusiast. He/him/they/them. Trans rights are human rights.

This profile is from a federated server and may be incomplete. Browse more on the original instance.

hazelweakly, to random
@hazelweakly@hachyderm.io avatar

I have a sudden mighty nerd to write a parody of Ella Fitzgerald's song "a tisket a tasket" but about debugging a broken kubernetes cluster

I... I just need it, okay? For reasons

remoquete,
@remoquete@hachyderm.io avatar

@hazelweakly A cover of Trent Reznor's "Hurt" would do it, too.

remoquete, to random
@remoquete@hachyderm.io avatar

People usually say that I’m a pleasure to work with and that I’ve a highly collaborative spirit. The fact that I’m good at teamwork doesn’t mean that it comes naturally to me. Quite on the contrary, being a good teammate is a skill that I constantly need to train and refine. The following are things I remind myself on a daily basis, à la Dune’s inner monologues, to be a better teammate at work.

https://passo.uno/tips-working-tech-writers-team/

remoquete, to random
@remoquete@hachyderm.io avatar

Reading comments about documentation on Hacker News is generally depressing, especially when the only answer is bringing up the same framework all the time. Diataxis has become the "have you tried turning it off and on again" of docs.

liztai, to random
@liztai@hachyderm.io avatar

My current watch. Such a pretty poster. I just love mature male leads. Hardly get mature female leads, however 😅

remoquete,
@remoquete@hachyderm.io avatar

@liztai I'm discovering lots of things to watch thanks to your posts. Thank you!

remoquete,
@remoquete@hachyderm.io avatar

@liztai From time to time, yes! Camtasia Is the best option, really.

remoquete, to random
@remoquete@hachyderm.io avatar

To be a good individual contributor you have to be a good collective contributor.

remoquete, to random
@remoquete@hachyderm.io avatar

The biggest problem of docs-as-code is getting folks to use git. If you do quick edits through the UI, that's fine. For deeper things, it's forking and setting up remotes and then waking up one day to see submodules breaking. It's a mess for many open source projects. And if you're not technical enough, the mere thought of git reset --hard origin/main in the morning can be terrifying.

remoquete, to random
@remoquete@hachyderm.io avatar

I name my computers after locations from Lord of the Rings and the Silmarillion. My PC is a black tower, so I called it Isengard. My fair MacBook Air is Valinor. The Raspberry Pi is Bree.

remoquete, to random
@remoquete@hachyderm.io avatar

I have an Intel MacBook Air from 2020 lying around. What OS should I install on it that's not macOS or Windows? T2-ready distributions fail to detect the WiFi chipset for some reason.

remoquete, to random
@remoquete@hachyderm.io avatar

A friend of mine is looking for a DevRel Engineer. Security software company based in Belgium. Remote-first. Hit me up if you're interested.

remoquete, to random
@remoquete@hachyderm.io avatar

A few days ago I had an interesting conversation on the pros and cons of Markdown for technical documentation with Ed Marsh and Eric Holscherin a webinar hosted by Scott Abel. Here are some of the things I said during the webinar.

https://passo.uno/pros-cons-markdown/

remoquete,
@remoquete@hachyderm.io avatar

@underlap @edmarsh Markdown the tool is OK. It has its uses. It's easy to learn.

Whether it works or not depends on who's going to use it and for what purpose. A tightly-knit team of brilliant people will do wonders with it if they want.

liztai, (edited ) to random
@liztai@hachyderm.io avatar

A habit I am starting is to write a short sentence, like a diary entry, in Chinese every day. My writing is horrendous but this is one of the ways I am trying to remember the characters.

#Mandarin #Chinese #Languages #LanguageLearning

remoquete,
@remoquete@hachyderm.io avatar

@liztai I'm immensely awed every time I see someone writing in Chinese. I want to learn!

(I think I got which characters are "Today" ☺️)

remoquete,
@remoquete@hachyderm.io avatar

@liztai OMG, sure, how??

remoquete,
@remoquete@hachyderm.io avatar

@liztai Installing! We have a few Chinese schools here in town, I might try one...

remoquete,
@remoquete@hachyderm.io avatar

@liztai TIL!

remoquete, to random
@remoquete@hachyderm.io avatar

Watching in glee as a developer in my team spots GPT writing in an open source PR and rejects it.

molly0xfff, to random
@molly0xfff@hachyderm.io avatar

fuck i love blogs. if i had nothing but time i would just read blogs all day.

remoquete,
@remoquete@hachyderm.io avatar

@molly0xfff https://passo.uno (tech writing and tech comms)

remoquete, to random
@remoquete@hachyderm.io avatar

Today in Docs Speak:

"Spray and pray": Publishing docs that you know can't be fully accurate from the start, hoping they'll still be useful.

"Fire and forget": Publishing docs that aren't meant to be revised at a later stage, like release notes.

remoquete, to random
@remoquete@hachyderm.io avatar

"Eventually I ended up with a PDF that Preview claimed is larger than the entire universe – approximately 37 trillion light years square. Please don't try to print it."

Making a PDF that’s larger than Germany – alexwlchan

https://alexwlchan.net/2024/big-pdf/

liztai, to random
@liztai@hachyderm.io avatar

I always tell people that if I want to feel insulted about my culture, I'll watch Disney's Mulan (2020).

https://www.youtube.com/watch?v=N3QKq24e0HM

remoquete,
@remoquete@hachyderm.io avatar

@liztai Disney's Aladdin: "Hold my beer..."

remoquete, to random
@remoquete@hachyderm.io avatar

I want to see more docs tracks in tech conferences.

remoquete, to random
@remoquete@hachyderm.io avatar

If you’re shipping a product and that product is more difficult to use than a kazoo, you need the product to communicate to users through UX writing, docs, or both, and create a team in charge of executing the underlying content strategy.

https://passo.uno/signs-need-tech-writer/

remoquete, to random
@remoquete@hachyderm.io avatar

A brilliant idea! Developer docs and test suites can definitely benefit from each other as a single source of truth. https://www.docsastests.com/docs-as-tests/concept/2024/01/09/intro-docs-as-tests.html

remoquete, to random
@remoquete@hachyderm.io avatar

I've just published a new blog post on what I call docs observability, or do11y. Enjoy! https://passo.uno/docs-observability-do11y/

  • All
  • Subscribed
  • Moderated
  • Favorites
  • •
  • JUstTest
  • kavyap
  • DreamBathrooms
  • thenastyranch
  • magazineikmin
  • tacticalgear
  • khanakhh
  • Youngstown
  • mdbf
  • slotface
  • rosin
  • everett
  • ngwrru68w68
  • Durango
  • megavids
  • InstantRegret
  • cubers
  • GTA5RPClips
  • cisconetworking
  • ethstaker
  • osvaldo12
  • modclub
  • normalnudes
  • provamag3
  • tester
  • anitta
  • Leos
  • lostlight
  • All magazines
    •