Pros and Cons of AI Technical Writing Dark _ □ ✕
  • Posts
  • About
  • Debug
Post

Pros and Cons of AI Technical Writing

Published
2026-08-28 12:21 UTC (precision: second)
Author
Endgame Viable
Source feed
Endgame Viable [exclude this blog]
Link
https://endgameviable.com/post/2026/08/pros-and-cons-of-ai-technical-writing/
Canonical
https://endgameviable.com/post/2026/08/pros-and-cons-of-ai-technical-writing
Length
3443 runes
Extracted text
Whoops I have nothing prepared today either. Let’s talk about AI writing. People love talking about AI writing, don’t they? Everyone knows that AI is quite bad at creative writing, however there’s one area where I think AI writing is perfectly acceptable, and that’s technical writing. Technical writing doesn’t have to be creative. It’s just there to communicate information concisely and accurately, so that the reader can absorb and use that knowledge, or use it as a reference. In the day job I’ve been working on a spike document to investigate some new strategies for automated testing, and as an experiment I’ve been getting Claude to write most of it. Claude is quite capable of explaining technical topics in a way that a knowledgable engineer can read it and understand it. So no problem there. However Claude is not particularly adept at structuring documents for narrative flow. And it has a habit of throwing in extraneous sentences and subjects that aren’t particularly relevant to the topic at hand. And it tends to run on a bit. Not every subject needs a complete encyclopedia entry. So it definitely needs a human editor. Getting Claude to write a document is very much like playing the role of an editor, sending messages to an author who doesn’t quite get what you’re trying to say, but keeps trying anyway. Eventually you get frustrated and go in and fix it yourself. Claude writes in Markdown, which doesn’t translate very well to Google Docs, which is the preferred document format at work. That’s another obstacle to overcome. The other thing about Claude in the day job is that it’s very slow. It takes a long, long time to think before returning with answers. It’s so slow that it’s borderline not worth waiting for it, and it could actually be faster to manually complete the tasks. I don’t know if it’s Claude in general or just my employer’s plan, but it’s by far the slowest AI agent I’ve ever used, to the point where it’s pretty frustrating. Basically you type a prompt, and then tab away to some other task to work on while you wait for the AI to think and respond. Maybe you get up and go get a drink. Maybe you watch a bit of something on YouTube while you wait. Usually you’ve forgotten what you were doing by the time the AI answers. It’s really, really slow. When I use Google’s Antigravity at home, it’s vastly faster. I mean it’s night and day. Claude didn’t used to be that slow, so I have to assume it’s buckling under the pressure of all the queries it has to deal with, now that everyone at work is judged in their performance reviews by how much they utilize AI to speed up their day-to-day activities. Ironically, because Claude is so slow to respond now, AI is actually slowing us down. Whoopsie. So will I be using AI from now on to write complete technical documents from start to finish? Probably not, unless I couldn’t care less about the topic or the audience. It’s not very efficient. But would I use AI explanations in my own technical documents? A hybrid approach makes sense. If I can read AI’s writing and understand it enough to act on the information, and it’s accurate, why not pass it along to other engineers? And I know what you’re thinking: It is accurate. I check it all the time. Nobody would be using AI if it was wrong all the time. And for the times Claude does get something wrong, I yell at it and revel in its groveling apologies. This post is for day 28 of Blaugust 2026.
Stored topics

Every stored assignment is listed, including rows below the current cutoff (0.75), so a missing tag can be explained.

Concept Code Score Meter Margin Origin Path
science and technology science-and-technology 0.99 5.04 direct science and technology
economy, business and finance economy-business-and-finance 0.99 4.62 ↑derived from 20000225 economy, business and finance
products and services products-and-services 0.99 4.62 ↑derived from 20000225 economy, business and finance > products and services
computing and information technology computing-and-information-technology 0.99 4.62 direct economy, business and finance > products and services > computing and information technology
technology and engineering technology-and-engineering 0.99 4.53 direct science and technology > technology and engineering
information technology and computer science information-technology-and-computer 0.98 3.69 direct science and technology > technology and engineering > information technology and computer science
artificial intelligence artificial-intelligence 0.95 2.90 direct science and technology > technology and engineering > information technology and computer science > artificial intelligence
software and applications software-and-applications 0.94 2.78 direct economy, business and finance > products and services > computing and information technology > software and applications
labour labour 0.67 0.71 direct labour
Information security information-security 0.47 -0.11 direct science and technology > technology and engineering > information technology and computer science > Information security
Software development software-development 0.46 -0.17 direct economy, business and finance > products and services > computing and information technology > software and applications > Software development
lifestyle and leisure lifestyle-and-leisure 0.23 -1.19 ↑derived from 20000538 lifestyle and leisure
leisure leisure 0.23 -1.19 direct lifestyle and leisure > leisure
Open source open-source 0.12 -1.96 direct economy, business and finance > products and services > computing and information technology > software and applications > Open source
media and entertainment industry media-and-entertainment-industry 0.10 -2.15 ↑derived from 20000306 economy, business and finance > products and services > media and entertainment industry
books and publishing books-and-publishing 0.10 -2.15 direct economy, business and finance > products and services > media and entertainment industry > books and publishing
social sciences social-sciences 0.10 -2.15 direct science and technology > social sciences
environment environment 0.09 -2.29 direct environment
society society 0.08 -2.38 ↑derived from 20001300 society
fundamental rights fundamental-rights 0.08 -2.38 ↑derived from 20001300 society > fundamental rights
privacy privacy 0.08 -2.38 direct society > fundamental rights > privacy
education education 0.08 -2.49 direct education
scientific research scientific-research 0.06 -2.74 ↑derived from 20000739 science and technology > scientific research
scientific exploration scientific-exploration 0.06 -2.74 ↑derived from 20000739 science and technology > scientific research > scientific exploration
space exploration space-exploration 0.06 -2.74 direct science and technology > scientific research > scientific exploration > space exploration
arts, culture, entertainment and media arts-culture-entertainment-and-media 0.05 -2.93 ↑derived from 20000013 arts, culture, entertainment and media
arts and entertainment arts-and-entertainment 0.05 -2.93 ↑derived from 20000013 arts, culture, entertainment and media > arts and entertainment
literature literature 0.05 -2.93 direct arts, culture, entertainment and media > arts and entertainment > literature
hobby hobby 0.05 -2.94 direct lifestyle and leisure > leisure > hobby
game game 0.04 -3.21 ↑derived from local:mmorpg lifestyle and leisure > leisure > game
video game video-game 0.04 -3.21 ↑derived from local:mmorpg lifestyle and leisure > leisure > game > video game
MMORPG mmorpg 0.04 -3.21 direct lifestyle and leisure > leisure > game > video game > MMORPG
culture culture 0.03 -3.34 direct arts, culture, entertainment and media > culture
crime, law and justice crime-law-and-justice 0.03 -3.41 ↑derived from 20000086 crime, law and justice
crime crime 0.03 -3.41 ↑derived from 20000086 crime, law and justice > crime
cyber crime cyber-crime 0.03 -3.41 direct crime, law and justice > crime > cyber crime
politics and government politics-and-government 0.03 -3.44 direct politics and government
Cryptography cryptography 0.03 -3.44 direct science and technology > technology and engineering > information technology and computer science > Cryptography
mass media mass-media 0.03 -3.61 ↑derived from local:blogging arts, culture, entertainment and media > mass media
social media social-media 0.03 -3.61 ↑derived from local:blogging arts, culture, entertainment and media > mass media > social media
Blogging blogging 0.03 -3.61 direct arts, culture, entertainment and media > mass media > social media > Blogging
Self-hosting self-hosting 0.02 -3.75 direct economy, business and finance > products and services > computing and information technology > Self-hosting
sport sport 0.02 -3.81 ↑derived from 20001183 sport
competition discipline competition-discipline 0.02 -3.81 ↑derived from 20001183 sport > competition discipline
eSports esports 0.02 -3.81 direct sport > competition discipline > eSports
health health 0.02 -4.01 ↑derived from 20000458 health
disease and condition disease-and-condition 0.02 -4.01 ↑derived from 20000458 health > disease and condition
mental health and disorder mental-health-and-disorder 0.02 -4.01 direct health > disease and condition > mental health and disorder
history history 0.02 -4.05 direct science and technology > social sciences > history
family family 0.02 -4.07 direct society > family
human interest human-interest 0.02 -4.14 direct human interest
Tabletop gaming tabletop-gaming 0.01 -4.19 direct lifestyle and leisure > leisure > game > Tabletop gaming
disaster, accident and emergency incident disaster-accident-and-emergency-incident 0.01 -4.31 direct disaster, accident and emergency incident
natural science natural-science 0.01 -4.50 ↑derived from 20000719 science and technology > natural science
biology biology 0.01 -4.50 direct science and technology > natural science > biology
award and prize award-and-prize 0.01 -4.71 direct human interest > award and prize
animation animation 0.01 -4.71 direct arts, culture, entertainment and media > arts and entertainment > animation
public health public-health 0.01 -4.76 direct health > public health
film industry film-industry 0.01 -4.77 direct economy, business and finance > products and services > media and entertainment industry > film industry
conflict, war and peace conflict-war-and-peace 0.01 -4.88 direct conflict, war and peace
television television 0.01 -5.05 direct arts, culture, entertainment and media > mass media > television
health treatment and procedure health-treatment-and-procedure 0.01 -5.15 direct health > health treatment and procedure
religion religion 0.00 -5.43 direct religion
climate change climate-change 0.00 -5.54 direct environment > climate change
streaming service streaming-service 0.00 -5.61 direct economy, business and finance > products and services > media and entertainment industry > streaming service
podcast podcast 0.00 -6.14 direct economy, business and finance > products and services > media and entertainment industry > podcast
consumer goods consumer-goods 0.00 -6.19 ↑derived from 20001160 economy, business and finance > products and services > consumer goods
handicrafts handicrafts 0.00 -6.19 direct economy, business and finance > products and services > consumer goods > handicrafts
travel and tourism travel-and-tourism 0.00 -6.26 direct lifestyle and leisure > leisure > travel and tourism
diet diet 0.00 -6.34 direct health > health treatment and procedure > diet
visual arts visual-arts 0.00 -6.59 ↑derived from 20000036 arts, culture, entertainment and media > arts and entertainment > visual arts
photography photography 0.00 -6.59 direct arts, culture, entertainment and media > arts and entertainment > visual arts > photography
lifestyle lifestyle 0.00 -6.74 ↑derived from 20001257 lifestyle and leisure > lifestyle
house and home house-and-home 0.00 -6.74 ↑derived from 20001257 lifestyle and leisure > lifestyle > house and home
gardening gardening 0.00 -6.74 direct lifestyle and leisure > lifestyle > house and home > gardening
exercise and fitness exercise-and-fitness 0.00 -6.84 direct lifestyle and leisure > wellness > exercise and fitness
wellness wellness 0.00 -6.84 ↑derived from 20001239 lifestyle and leisure > wellness
weather weather 0.00 -6.85 direct weather
food and drink enthusiasm food-and-drink-enthusiasm 0.00 -6.93 direct lifestyle and leisure > leisure > hobby > food and drink enthusiasm
music music 0.00 -7.04 direct arts, culture, entertainment and media > arts and entertainment > music
card game card-game 0.00 -7.19 direct lifestyle and leisure > leisure > game > card game
weather forecast weather-forecast 0.00 -7.20 direct weather > weather forecast
board game board-game 0.00 -7.49 direct lifestyle and leisure > leisure > game > board game

← Back to posts

feedtagger 0.1.0-dev model: modernbert-base-zeroshot-v2.0/int8@all-s256 2115 posts 0 unclassified min score 0.75