sakurakat.systems/posts/why-ru...
Another month, another blog post
This time it's about why I prefer #rustlang, and it's not because of memory safety :P
#LearningInPublic #TechnicalWriting #TechBlog
Another month, another blog post
This time it's about why I prefer #rustlang, and it's not because of memory safety :P
#LearningInPublic #TechnicalWriting #TechBlog
Why Rust? - Sakura Kat Systems
Rust's v1.0 hit 10 year mark recently so I wanted to write about why I like, and prefer Rust over the other languages I've tried. The fact of the matter is that Rust's memory safety plays a smaller ro...
sakurakat.systems
June 17, 2025 at 2:50 PM
sakurakat.systems/posts/why-ru...
Another month, another blog post
This time it's about why I prefer #rustlang, and it's not because of memory safety :P
#LearningInPublic #TechnicalWriting #TechBlog
Another month, another blog post
This time it's about why I prefer #rustlang, and it's not because of memory safety :P
#LearningInPublic #TechnicalWriting #TechBlog
Quarto code annotations in Typst?! 😏
(And fancy code blocks)
#Quarto #QuartoPub #Typst #TechnicalWriting #Teaching
(And fancy code blocks)
#Quarto #QuartoPub #Typst #TechnicalWriting #Teaching
February 1, 2026 at 8:02 PM
Quarto code annotations in Typst?! 😏
(And fancy code blocks)
#Quarto #QuartoPub #Typst #TechnicalWriting #Teaching
(And fancy code blocks)
#Quarto #QuartoPub #Typst #TechnicalWriting #Teaching
Two tips for rulebook writers:
1) Use FEWER header levels. Make sure there's at least a sentence below each header.
2) Everything should not be a list. Step-by-step instructions or bulleted lists of conditional exceptions. Pretty much it.
#BoardGame #TechnicalWriting #Editing #Layout #GraphicDesign
1) Use FEWER header levels. Make sure there's at least a sentence below each header.
2) Everything should not be a list. Step-by-step instructions or bulleted lists of conditional exceptions. Pretty much it.
#BoardGame #TechnicalWriting #Editing #Layout #GraphicDesign
November 7, 2024 at 4:38 PM
Two tips for rulebook writers:
1) Use FEWER header levels. Make sure there's at least a sentence below each header.
2) Everything should not be a list. Step-by-step instructions or bulleted lists of conditional exceptions. Pretty much it.
#BoardGame #TechnicalWriting #Editing #Layout #GraphicDesign
1) Use FEWER header levels. Make sure there's at least a sentence below each header.
2) Everything should not be a list. Step-by-step instructions or bulleted lists of conditional exceptions. Pretty much it.
#BoardGame #TechnicalWriting #Editing #Layout #GraphicDesign
Thrilled to share that I’ve earned my AI Technical Writing certification from Technical Writing HQ! Excited to use this knowledge to create more inclusive, accessible, and impactful content. Here’s to the future of tech writing! #AI #TechnicalWriting
January 13, 2025 at 4:03 PM
Thrilled to share that I’ve earned my AI Technical Writing certification from Technical Writing HQ! Excited to use this knowledge to create more inclusive, accessible, and impactful content. Here’s to the future of tech writing! #AI #TechnicalWriting
Most tech failures aren’t code failures—they’re clarity failures. In Systems, Translated Issue 02, I look at why technical documentation isn’t an afterthought but the infrastructure that lets us trust complex systems.
Full edition on LinkedIn:
#TechnicalWriting #AIGovernance #Documentation
Full edition on LinkedIn:
#TechnicalWriting #AIGovernance #Documentation
LinkedIn Login, Sign in | LinkedIn
Login to LinkedIn to keep in touch with people you know, share ideas, and build your career.
www.linkedin.com
September 27, 2026 at 2:27 AM
Most tech failures aren’t code failures—they’re clarity failures. In Systems, Translated Issue 02, I look at why technical documentation isn’t an afterthought but the infrastructure that lets us trust complex systems.
Full edition on LinkedIn:
#TechnicalWriting #AIGovernance #Documentation
Full edition on LinkedIn:
#TechnicalWriting #AIGovernance #Documentation
Code Window 1.0.0 for Quarto is here.
Add window-style decorations to your code blocks: macOS traffic lights, Windows buttons, or a plain title bar.
Hotfixes: Filename and code-annotations for Typst/PDF in Quarto 1.9.
github.com/mcanouil/quarto-code-window
#Quarto #Typst #TechnicalWriting
Add window-style decorations to your code blocks: macOS traffic lights, Windows buttons, or a plain title bar.
Hotfixes: Filename and code-annotations for Typst/PDF in Quarto 1.9.
github.com/mcanouil/quarto-code-window
#Quarto #Typst #TechnicalWriting
March 29, 2026 at 4:21 PM
Code Window 1.0.0 for Quarto is here.
Add window-style decorations to your code blocks: macOS traffic lights, Windows buttons, or a plain title bar.
Hotfixes: Filename and code-annotations for Typst/PDF in Quarto 1.9.
github.com/mcanouil/quarto-code-window
#Quarto #Typst #TechnicalWriting
Add window-style decorations to your code blocks: macOS traffic lights, Windows buttons, or a plain title bar.
Hotfixes: Filename and code-annotations for Typst/PDF in Quarto 1.9.
github.com/mcanouil/quarto-code-window
#Quarto #Typst #TechnicalWriting
Geminiに写真から線画にしてもらった。
普段使ってるワイヤレスイヤホン。
デカルは適当な文字になってるけど、
外郭線は指示通りに強調されてる。
ファイル形式については指示しなかったからPNGで出てるけど、
SVGとかベクター形式で出せれば修正もできそう。
マニュアル制作のプロユースとしては疑問だが、
社内向けマニュアルとかなら十分なのでは。
いやあ、時代の進化って怖いなぁ。
#illustration #technicalwriting #イラスト #テクニカルライティング
普段使ってるワイヤレスイヤホン。
デカルは適当な文字になってるけど、
外郭線は指示通りに強調されてる。
ファイル形式については指示しなかったからPNGで出てるけど、
SVGとかベクター形式で出せれば修正もできそう。
マニュアル制作のプロユースとしては疑問だが、
社内向けマニュアルとかなら十分なのでは。
いやあ、時代の進化って怖いなぁ。
#illustration #technicalwriting #イラスト #テクニカルライティング
September 7, 2025 at 12:12 AM
Geminiに写真から線画にしてもらった。
普段使ってるワイヤレスイヤホン。
デカルは適当な文字になってるけど、
外郭線は指示通りに強調されてる。
ファイル形式については指示しなかったからPNGで出てるけど、
SVGとかベクター形式で出せれば修正もできそう。
マニュアル制作のプロユースとしては疑問だが、
社内向けマニュアルとかなら十分なのでは。
いやあ、時代の進化って怖いなぁ。
#illustration #technicalwriting #イラスト #テクニカルライティング
普段使ってるワイヤレスイヤホン。
デカルは適当な文字になってるけど、
外郭線は指示通りに強調されてる。
ファイル形式については指示しなかったからPNGで出てるけど、
SVGとかベクター形式で出せれば修正もできそう。
マニュアル制作のプロユースとしては疑問だが、
社内向けマニュアルとかなら十分なのでは。
いやあ、時代の進化って怖いなぁ。
#illustration #technicalwriting #イラスト #テクニカルライティング
Why I switched from #Markdown to #Asciidoc for #technicalwriting.
Markdown is good, but Asciidoc is much more! It natively handles file includes, admonitions, spans in tables, and even diagrams—perfect for books, docs, and workshops.
Time to level up!
Markdown is good, but Asciidoc is much more! It natively handles file includes, admonitions, spans in tables, and even diagrams—perfect for books, docs, and workshops.
Time to level up!
AsciiDoc over Markdown
I taught myself HTML a long time ago, on a software called HotDog (Pro?). There wasn’t such a thing as WYSIWYG capabilities at the time. However, HotDog had an amazing feature: the toolbar had all HTM...
blog.frankel.ch
October 26, 2025 at 5:18 PM
Why I switched from #Markdown to #Asciidoc for #technicalwriting.
Markdown is good, but Asciidoc is much more! It natively handles file includes, admonitions, spans in tables, and even diagrams—perfect for books, docs, and workshops.
Time to level up!
Markdown is good, but Asciidoc is much more! It natively handles file includes, admonitions, spans in tables, and even diagrams—perfect for books, docs, and workshops.
Time to level up!
Who do I admire for #technicalWriting? Lots of people, but @techknitter.bsky.social is high on my list.
I just read a new-to-me article about managing long floats in knitting, and it has everything: technique, theory, example, illustration.
techknitting.blogspot.com/2016/10/tami...
I just read a new-to-me article about managing long floats in knitting, and it has everything: technique, theory, example, illustration.
techknitting.blogspot.com/2016/10/tami...
Taming long floats via the STUART method for color-knitting
knitting blog
techknitting.blogspot.com
January 21, 2025 at 8:50 PM
Who do I admire for #technicalWriting? Lots of people, but @techknitter.bsky.social is high on my list.
I just read a new-to-me article about managing long floats in knitting, and it has everything: technique, theory, example, illustration.
techknitting.blogspot.com/2016/10/tami...
I just read a new-to-me article about managing long floats in knitting, and it has everything: technique, theory, example, illustration.
techknitting.blogspot.com/2016/10/tami...
Today's #TechnicalWriting statement to a trusted engineer when he (correctly) told me I was wrong:
"No, don't apologize. It's important that the _docs_ be right, not that _Amy_ be right. Crucial difference there."
"No, don't apologize. It's important that the _docs_ be right, not that _Amy_ be right. Crucial difference there."
December 21, 2023 at 7:16 PM
Today's #TechnicalWriting statement to a trusted engineer when he (correctly) told me I was wrong:
"No, don't apologize. It's important that the _docs_ be right, not that _Amy_ be right. Crucial difference there."
"No, don't apologize. It's important that the _docs_ be right, not that _Amy_ be right. Crucial difference there."
I've finally gotten around to pinning a wee introduction from when I first joined. So this is me!
I also have a regular blog called Red Pens and Playwriting where I post about writerly things: red-pens-and-playwriting.ghost.io
#Writing #WritingCommunity #TechnicalWriting #CreativeWriting
I also have a regular blog called Red Pens and Playwriting where I post about writerly things: red-pens-and-playwriting.ghost.io
#Writing #WritingCommunity #TechnicalWriting #CreativeWriting
October 18, 2024 at 5:56 AM
I've finally gotten around to pinning a wee introduction from when I first joined. So this is me!
I also have a regular blog called Red Pens and Playwriting where I post about writerly things: red-pens-and-playwriting.ghost.io
#Writing #WritingCommunity #TechnicalWriting #CreativeWriting
I also have a regular blog called Red Pens and Playwriting where I post about writerly things: red-pens-and-playwriting.ghost.io
#Writing #WritingCommunity #TechnicalWriting #CreativeWriting
Yo dawg, I heard you like writing. So I wrote a blog post about writing so you can learn how to write while I was writing it.
Tina's Hints For Writing Gud: robotgirlgang.com/2026/09/23/t...
#ProfessionalDevelopment #Writing #TechnicalWriting #LLM
Tina's Hints For Writing Gud: robotgirlgang.com/2026/09/23/t...
#ProfessionalDevelopment #Writing #TechnicalWriting #LLM
https://robotgirlgang.com/2026/09/23/tinas-hints-for-writing-gud/
robotgirlgang.com
September 23, 2026 at 1:04 PM
Yo dawg, I heard you like writing. So I wrote a blog post about writing so you can learn how to write while I was writing it.
Tina's Hints For Writing Gud: robotgirlgang.com/2026/09/23/t...
#ProfessionalDevelopment #Writing #TechnicalWriting #LLM
Tina's Hints For Writing Gud: robotgirlgang.com/2026/09/23/t...
#ProfessionalDevelopment #Writing #TechnicalWriting #LLM
I started my blog 17 years ago as a hobby. At the time, I had no clue about #technicalwriting. Since then, the landscape has changed a lot, to the point that companies hire for technical writer positions. I was curious to evaluate what I learned by doing.
#bookreview
#bookreview
Writing for Developers
I started this blog seventeen as a hobby years ago, in April 2008. At the time, I had no clue about technical writing. I’m pretty sure it was not even a thing back then: the only content aimed at deve...
blog.frankel.ch
May 25, 2025 at 5:39 PM
I started my blog 17 years ago as a hobby. At the time, I had no clue about #technicalwriting. Since then, the landscape has changed a lot, to the point that companies hire for technical writer positions. I was curious to evaluate what I learned by doing.
#bookreview
#bookreview
As conversations about the future of tech continue, Women in Technical Communication reminds us who helped shape the past. #TechnicalWriting #ContentStrategy #WomenInSTEM
Women in Technical Communication: From typewriters to touchscreens
Women in Technical Communication: From typewriters to touchscreens: a history by the women who did the work
a.co
May 25, 2026 at 11:01 PM
As conversations about the future of tech continue, Women in Technical Communication reminds us who helped shape the past. #TechnicalWriting #ContentStrategy #WomenInSTEM
In the last few weeks I've started using #docsify at it seems a pretty amazing tool for documenting my latest #unrealengine project.
#docs #documentation #technicalwriting #gamedev #ue5 #gameprogramming
#docs #documentation #technicalwriting #gamedev #ue5 #gameprogramming
July 22, 2026 at 9:09 AM
In the last few weeks I've started using #docsify at it seems a pretty amazing tool for documenting my latest #unrealengine project.
#docs #documentation #technicalwriting #gamedev #ue5 #gameprogramming
#docs #documentation #technicalwriting #gamedev #ue5 #gameprogramming
Hello, all. I'm currently looking for a new job. My skills include technical/professional writing, blogging, WordPress, and general clerical skills. Looking for work in the Seattle area; open to remote.
Portfolio: www.diversetechgeek.com/portfolio/
#TechnicalWriting #clerical #HireMe #jobs
Portfolio: www.diversetechgeek.com/portfolio/
#TechnicalWriting #clerical #HireMe #jobs
Portfolio
The writing portfolio of Anthony Dean. Anthony is available for freelance technical and professional writing services.
www.diversetechgeek.com
October 30, 2025 at 1:25 AM
Hello, all. I'm currently looking for a new job. My skills include technical/professional writing, blogging, WordPress, and general clerical skills. Looking for work in the Seattle area; open to remote.
Portfolio: www.diversetechgeek.com/portfolio/
#TechnicalWriting #clerical #HireMe #jobs
Portfolio: www.diversetechgeek.com/portfolio/
#TechnicalWriting #clerical #HireMe #jobs
Hello 🌟I am a grad student working on a research project exploring how AI impacts technical writing education. If you are a technical writing instructor, please complete the survey: qualtricsxmx4wdc39v7.qualtrics.com/jfe/form/SV_...
Thank you!
#Technicalwriting #AIineducation #survey #academicsky
Thank you!
#Technicalwriting #AIineducation #survey #academicsky
Qualtrics Survey | Qualtrics Experience Management
Thank you for participating in this survey! Your insights will help us understand the integration of AI in technical writing education. This survey should take about 5 minutes to complete.
qualtricsxmx4wdc39v7.qualtrics.com
November 16, 2024 at 2:25 AM
Hello 🌟I am a grad student working on a research project exploring how AI impacts technical writing education. If you are a technical writing instructor, please complete the survey: qualtricsxmx4wdc39v7.qualtrics.com/jfe/form/SV_...
Thank you!
#Technicalwriting #AIineducation #survey #academicsky
Thank you!
#Technicalwriting #AIineducation #survey #academicsky
#Technicalwriting and communications are key factors most organizations leverage in process design. Learn today: adrienne-s-school-2b8a.thinkific.com/courses/fund...
#Innovation #Globalization #TechNews #Careers #Writing #DITA #B2B #Trends #Business #Technology #ContentStrategy
#Innovation #Globalization #TechNews #Careers #Writing #DITA #B2B #Trends #Business #Technology #ContentStrategy
June 18, 2026 at 9:14 PM
#Technicalwriting and communications are key factors most organizations leverage in process design. Learn today: adrienne-s-school-2b8a.thinkific.com/courses/fund...
#Innovation #Globalization #TechNews #Careers #Writing #DITA #B2B #Trends #Business #Technology #ContentStrategy
#Innovation #Globalization #TechNews #Careers #Writing #DITA #B2B #Trends #Business #Technology #ContentStrategy
This #technicalwriting course is more than a course about concise, clear writing. It is about project development, analysis, and writing for businesses. Start Now: adrienne-s-school-2b8a.thinkific.com/courses/fund...
#L&D #Writing #Consulting #Design #Analysis #HR #Operations #Management
#L&D #Writing #Consulting #Design #Analysis #HR #Operations #Management
May 21, 2026 at 9:19 PM
This #technicalwriting course is more than a course about concise, clear writing. It is about project development, analysis, and writing for businesses. Start Now: adrienne-s-school-2b8a.thinkific.com/courses/fund...
#L&D #Writing #Consulting #Design #Analysis #HR #Operations #Management
#L&D #Writing #Consulting #Design #Analysis #HR #Operations #Management
Slowly getting back into blogging - the first one is going to be all about how 🍪 cookies work (because I thought I knew everything, but of course I was a total Jon Snow once I really started digging).
Spending way too much time ✨illustrating it✨ it but LOOK at her! #technicalwriting #illustration
Spending way too much time ✨illustrating it✨ it but LOOK at her! #technicalwriting #illustration
August 29, 2024 at 6:06 PM
Slowly getting back into blogging - the first one is going to be all about how 🍪 cookies work (because I thought I knew everything, but of course I was a total Jon Snow once I really started digging).
Spending way too much time ✨illustrating it✨ it but LOOK at her! #technicalwriting #illustration
Spending way too much time ✨illustrating it✨ it but LOOK at her! #technicalwriting #illustration
My favorite way to document a complex system architecture is to start with a 'check it out, this system is basically just three things that talk to each other!' and then slowly, geeently start looking under rocks. Slow-motion bamboozlin'. #technicalwriting #documentation
a man in a suit says i was tricked in front of an imdb sign
Alt: A .gif of an older man on a talk show pointing his finger at someone off-camera and saying 'I was tricked'.
media.tenor.com
August 28, 2024 at 11:58 AM
My favorite way to document a complex system architecture is to start with a 'check it out, this system is basically just three things that talk to each other!' and then slowly, geeently start looking under rocks. Slow-motion bamboozlin'. #technicalwriting #documentation
Described my job today as "facilitating the rant-to-merge-request pipeline."
A decent % of my job is finding a subject matter expert, setting up coffee chats, asking about their subject, and typing VERY quietly while they infodump.
#TechnicalWriting
A decent % of my job is finding a subject matter expert, setting up coffee chats, asking about their subject, and typing VERY quietly while they infodump.
#TechnicalWriting
June 3, 2025 at 10:48 PM
Described my job today as "facilitating the rant-to-merge-request pipeline."
A decent % of my job is finding a subject matter expert, setting up coffee chats, asking about their subject, and typing VERY quietly while they infodump.
#TechnicalWriting
A decent % of my job is finding a subject matter expert, setting up coffee chats, asking about their subject, and typing VERY quietly while they infodump.
#TechnicalWriting
Most documentation has a structural problem that exists before any individual piece of writing: nobody has decided what kind of content belongs in the documentation and what each content type is supposed to do.
#diataxis #technicalwriting
stevearrants.substack.com/p/documentat...
#diataxis #technicalwriting
stevearrants.substack.com/p/documentat...
Documentation Frameworks: A Field Guide
Diátaxis is the one to start with, but DITA, minimalism, and others fill the gaps it leaves open.
stevearrants.substack.com
July 31, 2026 at 12:43 PM
Most documentation has a structural problem that exists before any individual piece of writing: nobody has decided what kind of content belongs in the documentation and what each content type is supposed to do.
#diataxis #technicalwriting
stevearrants.substack.com/p/documentat...
#diataxis #technicalwriting
stevearrants.substack.com/p/documentat...
من خبرة مهنية إلى مقالات عابرة للحدود، ومن كلمات منشورة إلى أثر يتواصل ... هذه رحلات معرفتي للناس.
#من_المقال_إلى_المرجع #تقانة_المعلومات #تقنية_المعلومات #الكتابة_التقنية #النشر_العلمي #التأثير_المعرفي #الهوية_المهنية #تقنية #المهندس_التقني #Cybersecurity #TechnicalWriting #KnowledgeSharing
#من_المقال_إلى_المرجع #تقانة_المعلومات #تقنية_المعلومات #الكتابة_التقنية #النشر_العلمي #التأثير_المعرفي #الهوية_المهنية #تقنية #المهندس_التقني #Cybersecurity #TechnicalWriting #KnowledgeSharing
September 26, 2026 at 7:54 PM
من خبرة مهنية إلى مقالات عابرة للحدود، ومن كلمات منشورة إلى أثر يتواصل ... هذه رحلات معرفتي للناس.
#من_المقال_إلى_المرجع #تقانة_المعلومات #تقنية_المعلومات #الكتابة_التقنية #النشر_العلمي #التأثير_المعرفي #الهوية_المهنية #تقنية #المهندس_التقني #Cybersecurity #TechnicalWriting #KnowledgeSharing
#من_المقال_إلى_المرجع #تقانة_المعلومات #تقنية_المعلومات #الكتابة_التقنية #النشر_العلمي #التأثير_المعرفي #الهوية_المهنية #تقنية #المهندس_التقني #Cybersecurity #TechnicalWriting #KnowledgeSharing
This month's blog post is about my experience with #jj-vcs
sakurakat.systems/posts/jj-my-...
#LearningInPublic #TechnicalWriting #TechBlog
sakurakat.systems/posts/jj-my-...
#LearningInPublic #TechnicalWriting #TechBlog
How Jujutsu VCS helps to lower the barrier to perfect git history - Sakura Kat Systems
Keeping a clean Git history is hard, but Jujutsu VCS changes that! Learn more about Jujutsu VCS in this blog post.
sakurakat.systems
May 13, 2025 at 6:43 AM
This month's blog post is about my experience with #jj-vcs
sakurakat.systems/posts/jj-my-...
#LearningInPublic #TechnicalWriting #TechBlog
sakurakat.systems/posts/jj-my-...
#LearningInPublic #TechnicalWriting #TechBlog