---
title: "#technical-writing articles | Hashnode"
description: "Explore 129 articles tagged #technical-writing on Hashnode. Tutorials, guides, and how-tos from the community."
url: "https://hashnode.com/tag/technical-writing"
---

Tag

# #technical-writing

129 posts · 11 followers

[Harshit Satyaseel](https://hashnode.com/@meharshit) · [12h ago](https://hashnode.com/posts/openapi-documentation-platforms-compared-mintlify-gitbook-velu-docs-and-document360/6afece52399536c9e3284e06)

### [OpenAPI Documentation Platforms Compared: Mintlify, GitBook, Velu Docs and Document360](https://tech-writing.hashnode.dev/openapi-documentation-platforms-compared-mintlify-gitbook-velu-docs-and-document360?utm_source=hashnode&utm_medium=feed)

I compared some of the best documentation tools for modern API documentation support so you don't have to, and here is my honest feedback

27 min read · [tech-writing.hashnode.dev](https://tech-writing.hashnode.dev/openapi-documentation-platforms-compared-mintlify-gitbook-velu-docs-and-document360?utm_source=hashnode&utm_medium=feed)

[Harshit Satyaseel](https://hashnode.com/@meharshit) · [2d ago](https://hashnode.com/posts/technical-writers-should-be-the-ones-writing-ai-skill-files/6afc0bef46b7f95521ec5fab)

### [Technical Writers Should Be the Ones Writing AI Skill Files](https://tech-writing.hashnode.dev/technical-writers-should-be-the-ones-writing-ai-skill-files?utm_source=hashnode&utm_medium=feed)

What a skill file is, why our job already trains us to write good ones, and how one can turn a PRD into consistent first drafts

8 min read · [tech-writing.hashnode.dev](https://tech-writing.hashnode.dev/technical-writers-should-be-the-ones-writing-ai-skill-files?utm_source=hashnode&utm_medium=feed)

[3](https://hashnode.com/posts/technical-writers-should-be-the-ones-writing-ai-skill-files/6afc0bef46b7f95521ec5fab)

[Chosen Vincent](https://hashnode.com/@ChosenVincent1) · [6d ago](https://hashnode.com/posts/migrating-from-inventory-api-v1-to-v2/6af771bb5ad708f24b88c4a1)

### [Migrating from Inventory API v1 to v2](https://chosenvincent.hashnode.dev/migrating-from-inventory-api-v1-to-v2?utm_source=hashnode&utm_medium=feed)

A sample API migration guide for moving from Inventory API v1 to v2, with before-and-after code for authentication, pagination, errors, and more.

7 min read · [chosenvincent.hashnode.dev](https://chosenvincent.hashnode.dev/migrating-from-inventory-api-v1-to-v2?utm_source=hashnode&utm_medium=feed)

[Greg](https://hashnode.com/@blogworkflow) · [6d ago](https://hashnode.com/posts/how-to-write-a-content-brief-for-a-technical-blog-post/6af6ecc48e0c94d790969672)

### [How to Write a Content Brief for a Technical Blog Post (One-Page Template)](https://blogworkflow.hashnode.dev/how-to-write-a-content-brief-for-a-technical-blog-post?utm_source=hashnode&utm_medium=feed)

Disclosure: written by the team behind BlogWorkflow, the SEO article writer mentioned near the end. This post was drafted with AI assistance and edited by a person. Most technical posts don't fail bec

5 min read · [blogworkflow.hashnode.dev](https://blogworkflow.hashnode.dev/how-to-write-a-content-brief-for-a-technical-blog-post?utm_source=hashnode&utm_medium=feed)

[Toolbit AI](https://hashnode.com/@toolbitai) · [Nov 12](https://hashnode.com/posts/verify-ai-generated-docs-against-the-code-before-you-merge-them/6af55b4003f632951bc196d5)

### [Verify AI-Generated Docs Against the Code Before You Merge Them](https://toolbitai.hashnode.dev/verify-ai-generated-docs-against-the-code-before-you-merge-them?utm_source=hashnode&utm_medium=feed)

An assistant can draft a README or API page that reads well and still describes code you do not have. A short verification pass before you merge.

3 min read · [toolbitai.hashnode.dev](https://toolbitai.hashnode.dev/verify-ai-generated-docs-against-the-code-before-you-merge-them?utm_source=hashnode&utm_medium=feed)

[1](https://hashnode.com/posts/verify-ai-generated-docs-against-the-code-before-you-merge-them/6af55b4003f632951bc196d5)

[M Yurtsever](https://hashnode.com/@velocms) · [Nov 8](https://hashnode.com/posts/are-blogs-still-worth-it-in-2026/6af08eb76eb9a76e71d8fec3)

### [Are blogs still worth it in 2026?](https://velocms.hashnode.dev/are-blogs-still-worth-it-in-2026?utm_source=hashnode&utm_medium=feed)

A cost-benefit look at developer blogging in 2026: time, hosting, what a post returns, how to measure it, and when to skip it.

20 min read · [velocms.hashnode.dev](https://velocms.hashnode.dev/are-blogs-still-worth-it-in-2026?utm_source=hashnode&utm_medium=feed)

[Sourav Mahapatra](https://hashnode.com/@souravmahapatra) · [Nov 8](https://hashnode.com/posts/readability-scores-explained-flesch-reading-ease-vs-flesch-kincaid-grade-with-the-formulas-and-a-worked-example/6af046686fa732826288ae82)

### [Readability scores explained: Flesch Reading Ease vs Flesch–Kincaid Grade (with the formulas and a worked example)](https://beginthings.hashnode.dev/readability-scores-explained-flesch-reading-ease-vs-flesch-kincaid-grade-with-the-formulas-and-a-worked-example?utm_source=hashnode&utm_medium=feed)

"Aim for a Flesch score of 60+." "Keep it at grade 8." You've probably heard both pieces of advice, sometimes in the same style guide, without anyone explaining where the numbers come from. They come

6 min read · [beginthings.hashnode.dev](https://beginthings.hashnode.dev/readability-scores-explained-flesch-reading-ease-vs-flesch-kincaid-grade-with-the-formulas-and-a-worked-example?utm_source=hashnode&utm_medium=feed)

[Jason Vertrees](https://hashnode.com/@jvertrees) · [Nov 3](https://hashnode.com/posts/addendum-getting-claude-to-write-release-notes-in-plain-english/6aea0c0efe7933d074c2fb6c)

### [Addendum: Getting Claude to Write Release Notes in Plain English](https://jvertrees.hashnode.dev/addendum-getting-claude-to-write-release-notes-in-plain-english?utm_source=hashnode&utm_medium=feed)

A follow-up to "Forcing Claude Code to Speak Human": what's broken in Claude's changelog voice, a rule block to stop it, and five before-and-after rewrites.

7 min read · [jvertrees.hashnode.dev](https://jvertrees.hashnode.dev/addendum-getting-claude-to-write-release-notes-in-plain-english?utm_source=hashnode&utm_medium=feed)

[2](https://hashnode.com/posts/addendum-getting-claude-to-write-release-notes-in-plain-english/6aea0c0efe7933d074c2fb6c)

[Gabe Garcia](https://hashnode.com/@rephraseai) · [Nov 2](https://hashnode.com/posts/another-way-to-say-best-practices-in-engineering-docs-and-talks/6ae8dc311bf5311d7eae5b4a)

### [Another way to say best practices in engineering docs and talks](https://rephraseai.hashnode.dev/another-way-to-say-best-practices-in-engineering-docs-and-talks?utm_source=hashnode&utm_medium=feed)

Best practices alternatives that tell readers who decided and why "Best practices" is one of the most common phrases in engineering writing. It shows up in design docs, onboarding guides, code review

5 min read · [rephraseai.hashnode.dev](https://rephraseai.hashnode.dev/another-way-to-say-best-practices-in-engineering-docs-and-talks?utm_source=hashnode&utm_medium=feed)

[CleverUtils](https://hashnode.com/@cleverutilscom) · [Oct 31](https://hashnode.com/posts/markdown-docx-and-pdf-in-a-docs-workflow-what-converts-cleanly-and-what-breaks/6ae65a714bf7de73d6f1df5b)

### [Markdown, DOCX and PDF in a Docs Workflow: What Converts Cleanly and What Breaks](https://cleverutils.hashnode.dev/markdown-docx-and-pdf-in-a-docs-workflow-what-converts-cleanly-and-what-breaks?utm_source=hashnode&utm_medium=feed)

Keep Markdown as the source, treat DOCX and PDF as outputs, and know where conversions lose data

7 min read · [cleverutils.hashnode.dev](https://cleverutils.hashnode.dev/markdown-docx-and-pdf-in-a-docs-workflow-what-converts-cleanly-and-what-breaks?utm_source=hashnode&utm_medium=feed)
