DEV Community

Umar Shehu
Umar Shehu

Posted on

2

Technical Writing Process for Absolute Beginners

technical writing

Introduction

The technical writing process is a step-by-step guide to writing a technical document. If you are an absolute beginner in technical writing, and about to write a technical document, follow these steps to guide you from planning to publishing.

Image description

1. Planning Stage: Planning is the first and crucial step. Good planning is associated with a sound published document. Three key points to consider during the planning stage are:

  • Purpose: Purpose asked the question “Why?”. Ask yourself, what is the purpose of writing this document?

  • Scope: Scope asked the question “What?”. What do you want to write about?

  • Audience: Pay attention to your audience. The audience asked the question “Who?”. Who are you writing the document for?

2. Research and Learn: Research for data or information about your document. Read and learn about the information you have researched. You need to have a solid knowledge of your subject matter.

3. Edit and Write: Edit your gathered information in a structured format. Write in a clean, clear, and concise manner. The audience should find your document easy to read and understand.

4. Edit and Review: Edit your document again. Check for incorrect grammar, misaligned paragraphs, and omitted punctuation. Review your document from the planning stage to the edit-and-write stage.

5. Publish: Choose a platform easily accessible to your targeted audience and publish your document.

Closing thoughts

A brief introduction to the technical writing process and the basic steps were introduced to the reader. Use this article as a guide, to writing and publishing your first technical document.

I am Umar Shehu, a passionate technical writer and documentation engineer. I use my 3Cs (clean, clear, and concise) format, to reach my targeted audience.

Sentry image

Hands-on debugging session: instrument, monitor, and fix

Join Lazar for a hands-on session where you’ll build it, break it, debug it, and fix it. You’ll set up Sentry, track errors, use Session Replay and Tracing, and leverage some good ol’ AI to find and fix issues fast.

RSVP here →

Top comments (2)

Collapse
 
ishaq_360 profile image
ISHAQ HASSAN

U writing is good, I find it very useful

Collapse
 
umarshehu profile image
Umar Shehu

Thank you, Ishaq.

A Workflow Copilot. Tailored to You.

Pieces.app image

Our desktop app, with its intelligent copilot, streamlines coding by generating snippets, extracting code from screenshots, and accelerating problem-solving.

Read the docs

👋 Kindness is contagious

Please leave a ❤️ or a friendly comment on this post if you found it helpful!

Okay