Buzz Chronicles
Follow
  • Home
  • Threads
    • Daily Charts
    • Most Popular
    • Most Recent
  • Authors
  • Categories
    • Life
    • Tech
    • Culture
    • Politics
    • Society
    • Fun
    • See All Categories
  • About

Inertia_m Categories Techwriting

7 days 30 days All time Recent Popular
Catalin Pit
Catalin Pit
@catalinmpit
I have seen some technical articles with really good content, but bad structure.

No matter how good the content is, bad structure puts people off from reading your articles!

So, here are 6 tips you can use to improve your articles straightaway! 👇

1/ Split your articles into sections

Don't write everything in one section because it makes it difficult to read. Moreover, it also confuses the reader.

See the two pictures - which article is easier to read and less confusing?


2/ The layout is important

A proper layout makes an article easier and more enjoyable to read

Make use of:
- whitespace
- bullet points
- headings
- sub-headings
- images

Once again, compare the two articles without headings and bullet points.


3/ Write for clarity

Avoid using fancy words and terminology, if not needed.

If you can simplify your article, do so. Your job is not to sound smart, but to be as clear as possible.

4/ Split your text into paragraphs

Sometimes, I see articles that have 1 or 2 enormous paragraphs.

It's incredibly tiring and difficult to read such articles.

Compare the two images - isn't it harder to read the article with those walls of text?
TECHWRITING
  • Page 1 of 1
How does it work?
  • 💬 Reply to a thread with "@buzz_chronicles save" or "@buzz_chronicles save as category"
    🤖 Our bot will send you a link to your own folder on Buzz Chronicles. The thread will be saved in a form of an easy-to-read article
    📁 All your saved threads will be available at buzzchronicles.com/your_twitter_handle
Buzz Chronicles
  • Explore
  • Threads
  • Daily Charts
  • Authors
  • Categories
  • About
  • Terms of Service

Copyright © 2021 Buzz Chronicles - All right reserved