aster.cloud aster.cloud
  • /
  • Platforms
    • Public Cloud
    • On-Premise
    • Hybrid Cloud
    • Data
  • Architecture
    • Design
    • Solutions
    • Enterprise
  • Engineering
    • Automation
    • Software Engineering
    • Project Management
    • DevOps
  • Programming
    • Learning
  • Tools
  • About
  • /
  • Platforms
    • Public Cloud
    • On-Premise
    • Hybrid Cloud
    • Data
  • Architecture
    • Design
    • Solutions
    • Enterprise
  • Engineering
    • Automation
    • Software Engineering
    • Project Management
    • DevOps
  • Programming
    • Learning
  • Tools
  • About
aster.cloud aster.cloud
  • /
  • Platforms
    • Public Cloud
    • On-Premise
    • Hybrid Cloud
    • Data
  • Architecture
    • Design
    • Solutions
    • Enterprise
  • Engineering
    • Automation
    • Software Engineering
    • Project Management
    • DevOps
  • Programming
    • Learning
  • Tools
  • About
  • DevOps
  • Programming
  • Tools

How To Write Better As A Developer

  • Ackley Wyndam
  • June 14, 2022
  • 4 minute read

Recently, I had two programming friends point out to me the importance of writing skills. It makes sense to pay attention to what they say because:

  • one runs an online product company,
  • and the other jumped from a bootcamp graduate to a lead developer within just a few years.

Let’s look at a short guide to improving your writing in your day-to-day job.


Partner with aster.cloud
for your next big idea.
Let us know here.



From our partners:

CITI.IO :: Business. Institutions. Society. Global Political Economy.
CYBERPOGO.COM :: For the Arts, Sciences, and Technology.
DADAHACKS.COM :: Parenting For The Rest Of Us.
ZEDISTA.COM :: Entertainment. Sports. Culture. Escape.
TAKUMAKU.COM :: For The Hearth And Home.
ASTER.CLOUD :: From The Cloud And Beyond.
LIWAIWAI.COM :: Intelligence, Inside and Outside.
GLOBALCLOUDPLATFORMS.COM :: For The World's Computing Needs.
FIREGULAMAN.COM :: For The Fire In The Belly Of The Coder.
ASTERCASTER.COM :: Supra Astra. Beyond The Stars.
BARTDAY.COM :: Prosperity For Everyone.

Break your text into paragraphs

The first step to improving your writing is to break your thoughts into digestible pieces. Instead of dumping a massive wall of text, put some space between sentences as your focus goes from one thing to another. Breaking things into paragraphs will make your text more economical, less overwhelming, and easier to read. Smaller chunks preserve your reader’s mental energy.

Image description

Don’t write like this.

Use some of the available stylings

Most systems where you will send your message have some styling available. You can expect to have at least:

  • bold,
  • italics,
  • headers,
  • underscores, or
  • strike through

Using these will make the quick parsing of your text more manageable. You can easily direct readers’ attention to the most important parts, making it more likely that you will achieve the goals of the text you’re writing.

Image description

Decoration makes a difference.

Make it easy for the reader

There are two things that you can do to make the lives of your readers easier:

  • use HTML links, and
  • include images in the text to convey your message or explain the issue

These editing options are not always available. For example, in Slack, I’m always annoyed that I cannot put images between paragraphs.

Read More  Introducing Certificate Manager To Simplify Saas Scale TLS And Certificate Management

When these options are available, using them significantly improves the readability of the text. One can see pictures immediately after they are referenced in text, and massive links are not breaking the flow of text.

This is essential in working with tickets. For example, in Jira, if you just add an image to the issue, it can still be clear when you have only one there. But as soon as the team adds five other pictures in comments, it can get confusing fast. Putting images inside text makes is clear which is relevant where.

Image description

The web has had links since 1991 and images since 1992. Let’s use them!

Read and edit what you wrote

A bit of editing can improve the first version of your text a lot. If you can, it’s best to save a draft and come back to edit later—maybe after some break or even the next day. At a minimum, rereading the whole text before publishing should allow you to tweak the way you say things to improve the reader’s overall impression of your text.

Editing is the key to a good reader experience. Doing it yourself should be good enough for most things you write, and it’s a basic courtesy for your readers.

Image description

Use automated tools to improve your writing

Dictionary checks are not the only ways machines can improve your writing. Nowadays, there are advanced tools available that can take care of things like:

  • catching correctly spelled words used in wrong places (as I do all the time with ‘then’ and ‘than’)
  • marking passive voice— using active voices makes your writing more vivid
  • reorganizing sentences to be easier to read — at least according to an algorithm
Read More  Beautiful Is Better Than Ugly': Using Python To Automate Your SEO Strategy

If you are serious about your writing, you should look at some available applications.

Grammarly

If you get similar YouTube ads, you have definitely heard about them. I’ve been using it since July 2021, and I’m pleased with it. It was the first serious quality improvement I implemented on my blog.

Pluses:

  • it understands the context of words and suggests changes accordingly: it will tell you if you mean “it’s” or “its”
  • it points out overused words and suggests other options
  • in the paid version, it can suggest restructuring of the sentence

Minuses

  • lack of support for languages other than English
  • the Firefox plugin on Mac struggles with Google Docs
  • the paid version is 144$/year, which is more than competitors
  • you can hear about security and privacy issues. From what I’ve searched, the most significant security breach was in 2018, and they fixed it quickly. The privacy issue is related to all processing happening on the company servers—so you need to trust the company to follow its terms of service.

[button style=’accent’ url=’https://aster.cloud/2021/04/10/tools-to-help-developers-provide-a-positive-user-experience/’ target=’_blank’ arrow=’true’ fullwidth=’true’]TOOLS TO HELP DEVELOPERS PROVIDE A POSITIVE USER EXPERIENCE[/button]

 

LanguageTools

Pluses:

  • it supports more languages (grammatical correction in 5 European languages), more basic support for 20 languages, and more
  • you can self-host the free version, so your data stays entirely under your control

Minuses:

  • less marketing—I only found them when I start asking around

Image description

Become the best friend of your readers

All these tips boil down to thinking about the people who will read your text. Your job is to make it easy for them to read it. It calls for being more empathetic. Putting in the extra effort should pay well for you: often, your readers are your boss or people who have an impact on your career. Even when you write for your colleagues, most likely there will be many of them—and it will serve you well to build a reputation as an efficient communicator.

Read More  15 DevOps Trends To Expect In 2021

This feature was originally appeared in how-todev.


For enquiries, product placements, sponsorships, and collaborations, connect with us at [email protected]. We'd love to hear from you!

Our humans need coffee too! Your support is highly appreciated, thank you!

Ackley Wyndam

Related Topics
  • Developers
  • html
  • Jira
  • Programmers
  • Programming
  • Tools
You May Also Like
notta-ai-header
View Post
  • Featured
  • Tools

Notta vs Fireflies: Which AI Transcription Tool Deserves Your Attention in 2025?

  • May 16, 2025
zedreviews-Apple-iPhone-16-Pro-finish-lineup-240909
View Post
  • Featured
  • Gears
  • Tech
  • Technology
  • Tools

Apple debuts iPhone 16 Pro and iPhone 16 Pro Max

  • September 10, 2024
zedreviews-Apple-AirPods-Active-Noise-Cancellation-240909
View Post
  • Featured
  • Gears
  • Tech
  • Technology
  • Tools

Apple introduces AirPods 4 and the world’s first all-in-one hearing health experience with AirPods Pro 2

  • September 10, 2024
View Post
  • DevOps
  • Engineering
  • Platforms

How To Fail At Platform Engineering

  • March 11, 2024
View Post
  • Computing
  • DevOps
  • Platforms

The IBM Approach To Reliable Quantum Computing

  • November 28, 2023
Automation
View Post
  • Automation
  • Platforms
  • Tools

Automate Your Data Warehouse Migration To BigQuery With New Data Migration Tool

  • August 24, 2023
DevOps artifact management
View Post
  • Design
  • DevOps
  • Engineering

10 Awesome Benefits Of Artifact Management And Why You Need It

  • August 2, 2023
Developers | Software | Program | Engineering
View Post
  • Software Engineering
  • Technology
  • Tools

Top IDEs And Compilers For C++.

  • July 4, 2023

Stay Connected!
LATEST
  • 1
    Just make it scale: An Aurora DSQL story
    • May 29, 2025
  • 2
    Reliance on US tech providers is making IT leaders skittish
    • May 28, 2025
  • Examine the 4 types of edge computing, with examples
    • May 28, 2025
  • AI and private cloud: 2 lessons from Dell Tech World 2025
    • May 28, 2025
  • 5
    TD Synnex named as UK distributor for Cohesity
    • May 28, 2025
  • Weigh these 6 enterprise advantages of storage as a service
    • May 28, 2025
  • 7
    Broadcom’s ‘harsh’ VMware contracts are costing customers up to 1,500% more
    • May 28, 2025
  • 8
    Pulsant targets partner diversity with new IaaS solution
    • May 23, 2025
  • 9
    Growing AI workloads are causing hybrid cloud headaches
    • May 23, 2025
  • Gemma 3n 10
    Announcing Gemma 3n preview: powerful, efficient, mobile-first AI
    • May 22, 2025
about
Hello World!

We are aster.cloud. We’re created by programmers for programmers.

Our site aims to provide guides, programming tips, reviews, and interesting materials for tech people and those who want to learn in general.

We would like to hear from you.

If you have any feedback, enquiries, or sponsorship request, kindly reach out to us at:

[email protected]
Most Popular
  • Understand how Windows Server 2025 PAYG licensing works
    • May 20, 2025
  • By the numbers: How upskilling fills the IT skills gap
    • May 21, 2025
  • 3
    Cloud adoption isn’t all it’s cut out to be as enterprises report growing dissatisfaction
    • May 15, 2025
  • 4
    Hybrid cloud is complicated – Red Hat’s new AI assistant wants to solve that
    • May 20, 2025
  • 5
    Google is getting serious on cloud sovereignty
    • May 22, 2025
  • /
  • Technology
  • Tools
  • About
  • Contact Us

Input your search keywords and press Enter.