shakedown.social is one of the many independent Mastodon servers you can use to participate in the fediverse.
A community for live music fans with roots in the jam scene. Shakedown Social is run by a team of volunteers (led by @clifff and @sethadam1) and funded by donations.

Administered by:

Server stats:

255
active users

#techwriting

0 posts0 participants0 posts today

Recurring #TechWriting issue that I still haven't found a good solution for:

Is anyone aware of a decently reliable automation for reformatting #Markdown text that previously used line length limits of 80 characters and forced line wraps, to one sentence per line?

Must preserve all Markdown formatting including tables and fenced code blocks.

(If you think this is trivial and can be solved with a sprinkling of regex — nope.)

Boosts appreciated!

This is what I think about AI's impact on writing as well. My belief is that we have to weather the storm of overly eager decisions by non-experts to replace people with AI ... and to quote a friend, "pick up the pieces later".

With writing, sure, it's really easy to vomit out a brochure copy, but you still need a writer to give it a human voice and to check for hallucinations. For high-level, complex tech writing that I do good luck trying to generate that.

Clients will sniff fakery a mile away and avoid your company like the plague.

We need to apply AI to our workflows in a more realistic way, not in a sci-fi way.

youtu.be/fJGNqnq-aCA?si=cE0uPB

youtu.be- YouTubeEnjoy the videos and music you love, upload original content, and share it all with friends, family, and the world on YouTube.
#AI#Tech#Writing

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.

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.

Trying out @omnivore and am pretty happy with it! It doesn't play as friendly with Firefox, but fixed it thanks to their docs (yay #techwriting) and was sad text to speech not available for Androids yet. I do depend on it a bit. (I like to listen to articles while working out.)
But the thing that I am super excited about, besides it being open source is that it can funnel your articles to #Obsidian.

I have to admit my current system isn't working for me.

#Pkm#App#Rss

You must be in the right job when you get a flood of tickets on a day where you feel really tired, but you're immensely happy and grateful that you have these tickets anyway.*

* I struggled hard to transition from journalism/marketing to #techwriting and I'm always immensely grateful I managed to make the transition and have notched almost 2 years of experience to date Excited to learn things that were only concepts to me before.

Discoveries in 2023 that improved my life greatly:
1. #PKM + #ObsidianMD helped me write 5x faster
2. #Fediverse - now mentally healthier but getting addicted to socmed again 😅
3. Rekinidled my ❤ for #CDramas
4. ❤️ #techwriting - feel like I'm now in my sweet spot, career wise.
5. #AlternateDayFasting + exercise consistency = 6kg weight loss.
6. #DigitalGarden - rekindled my ❤️ for blogging
6. Walkingpads. Why did I wait so long to get one??

A couple months ago , I had the opportunity to discuss what a day in the life of a technical writer looks like with a group of university students participating in Google's Tech Exchange. It was a wonderful experience and they posed many insightful questions, which reminded me that I have this discussion frequently enough that it's worth writing down in a more permanent nature.

todhilton.com/words/about-tech

tod hilton · Day in the life of a technical writerWhat’s a typical day like for a technical writer in the software industry?

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