Create accountLogin

Recent searches

No recent searches

Search options

Only available when logged in.
freeradical.zone is one of the many independent Mastodon servers you can use to participate in the fediverse.
Infosec and privacy and technology and leftward politics and cats and dogs and...

Administered by:

Server stats:

263
active users

freeradical.zone: AboutProfiles directoryPrivacy policy

Mastodon: AboutGet the appKeyboard shortcutsView source codev4.3.7

#techwriting

2 toots2 participants0 toots today
Public
jmac

I wrote up a tech-writing technique I call the assertions document. It helps you rapidly develop your own understanding of a new-to-you topic by getting your subject-matter experts engaged in the docs project as quickly as possible, and even eager to help you—largely by giving them ways to tell you how you're wrong. #TechWriting #TechnicalWriting fogknife.com/2025-04-04-streng

FogknifeStrengthen your tech writing by trolling your SMEsHow to make your subject-matter experts feel more invested in your work by being wrong and incomplete.
Public
RIPE NCC

Got insights on the past, present, or future of the Internet? Share your story on RIPE Labs for a chance to win a trip to RIPE 90 this May in Lisbon!

Deadline: Friday, 4 April
Time: 23:00 CET
Submit online via RIPE Labs

👉 More info & submit your entry: labs.ripe.net/competitions/rip

All articles go through the usual RIPE Labs review process—just tick the competition entry box when submitting.

Looking forward to reading your stories!

A digital banner with a light blue background promoting the RIPE Labs article competition. The text reads: "ENTER THE RIPE LABS ARTICLE COMPETITION" in bold uppercase letters, with "COMPETITION" highlighted in orange. Below, in smaller text, it states: "OPEN UNTIL 4 APRIL." On the right side, there is an abstract geometric pattern of blue outlined cubes and triangular shapes.
#RIPELabs#RIPE90#InternetInnovation
Public
Rebecca

Who has any 2025 job hunt advice?

- 3.5 years in #ux (mostly research)
- 7.5 years in digital #libraries
- 3 years in #techwriting
- About a year of #advertising media & #marketing

💖 I'm deeply passionate about finding ways to connect people with valuable information, but also quite flexible on the approach. I have plenty of time for virtual coffee if anyone wants to connect. ☕

Or shoot me your tips below if you have a minute!

#jobhunt
#jobs
#jobhunter
#career
#fedihired
#hiring

Public
heckj

If you're programming/coding I'd love your help here:

What are some of the best examples you've seen (that are public/I can view - any language is fine) of programming tutorials and/or example code?

I'm looking for the best examples that illustrate how a a program is put together, the patterns it's using, so that you do the same yourself.

#techwriting#docs#programming
Public
Nico

What a wonderful day an #UniventionSummit . I enjoyed meeting long term colleagues from other companies, getting to know inspiring new people, and exchanging experiences about #techwriting . I'm looking forward to the recordings of the talks, especially of "Digitale Enteignung - Wie Big Tech Wirtschaft und Demokratie zerstört" from Martin Andree.

Public
Daryl the Admin 🇺🇦

Calling those who write #documentation or work in a closely adjacent role!

The Write the Docs salary survey is live and available. This is for anyone who has been paid for documentation or documentation-adjacent work in the past year, regardless of current work status, employee/contractor classification, location, and so on.

salary-survey.writethedocs.org

Documentation Salary Survey 2024WTD Documentation Salary Survey 2024 - open for submissions!Our salary survey is now open for submissions! Help us create a benchmark for appropriate salary ranges for documentation roles world-wide.
#TechnicalWriting#techWriting#docs
Public
masukomi

Dear Geeks:
A friendly #TechWriting reminder. Just because YOU have a big vocabulary doesn't mean all your readers do.

Some people are young, or haven't had the opportunities to encounter as many words.

Some people don't have YOUR language as their native language.

All user facing strings _must_ be written with that in mind.

Here's an example of how NOT to do it. How many young coders or people new to English do you think know the meaning of "obsolescent" ?

How many native adults?

screenshot of terminal output. One line has been underlined. it says egrep: warning: egrep is obsolescent; using ggrep -E
Continued thread
Public
jmac

One of my favorite entries in the Google dev-docs style guide word list is for "simple": “What might be simple for you might not be simple for others. Try eliminating this word from the sentence because usually the same meaning can be conveyed without it.”

Google Search’s top hit for the thing I was trying to do is the following page, which counterexamples this to a painful degree. Every "quite simple" step made me say “I'm sorry, the *what*?” banjocode.com/post/hugo/custom #TechWriting

banjocode.comAdd Custom CSS Or Javascript To Your Hugo Site | banjocodeHugo themes are great - some do, however, not include custom CSS and JS from start. This is a simple guide on how to add it to your own Hugo site.
Public
jmac

Just spent two hours replicating a cool feature I miss from my former employer's in-house static-site generation system using Hugo and CSS. This article by Brian P. Hogan got me 66% of the way there, so thanks for that Brian P. Hogan! medium.com/pragmatic-programme

The rest was having Gemini give me answers that were, as usual, absolutely wrong but nonetheless rich with novel techniques for me to research and learn how to use correctly. Which I did! More or less.

How's your Monday going. #TechWriting

The Pragmatic Programmers · Displaying Shell Command Code Blocks in Hugo - The Pragmatic Programmers - MediumBy Brian P. Hogan
Public
Tom Klaver :prami:

#introduction

Hey! I'm Tom, and I was a #UXdesigner for Soda Studio, Apple, Lightspeed, and Prss. I'm recovering from #burnout and exploring what career I want to pursue. Could be #techwriting, could be #iosdevelopment, could be anything outside of IT. Time will tell what makes me the happiest!

Most importantly I'm a dad and live with my #autism. I love being a #parent, scratching my own itches with #Shortcuts and I listen to #falloutboy every single day. I'm stuck in 2005, music-wise.

ExploreLive feeds
About