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  Dynatrace Announces PurePath 4 With OpenTelemetry And Support For The Latest Cloud-native Architectures

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  Managing The Looker Ecosystem At Scale With SRE And DevOps Practices

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  10 Helpful Python Tips And Tricks For Beginners

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
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
Automation | Gears
View Post
  • Automation
  • DevOps
  • Engineering

Automating CI/CD With GitHub Actions

  • June 13, 2023
View Post
  • Architecture
  • Data
  • Engineering
  • People
  • Programming
  • Software Engineering
  • Technology

Predictions: Top 25 Careers Likely In High Demand In The Future

  • June 6, 2023
View Post
  • DevOps
  • People

What’s The Future Of DevOps? You Tell Us. Take The 2023 Accelerate State Of DevOps Survey

  • June 2, 2023
View Post
  • Engineering
  • Tools

Red Hat Puts Podman Container Management On The Desktop

  • May 30, 2023
View Post
  • Engineering
  • Practices
  • Tools

Tricentis Launches Quality Engineering Community ShiftSync

  • May 23, 2023

Stay Connected!
LATEST
  • 1
    Combining AI With A Trusted Data Approach On IBM Power To Fuel Business Outcomes
    • September 21, 2023
  • 2
    Start Your Ubuntu Confidential VM With Intel® TDX On Google Cloud
    • September 20, 2023
  • Microsoft and Adobe 3
    Microsoft And Adobe Partner To Deliver Cost Savings And Business Benefits
    • September 20, 2023
  • 4
    Huawei Connect 2023: Accelerating Intelligence For Shared Success
    • September 20, 2023
  • 5
    Huawei Releases Data Center 2030, Leading Innovation and Development of New Data Centers
    • September 20, 2023
  • Penguin 6
    How To Find And Fix Broken Packages On Linux
    • September 19, 2023
  • Volkswagen 7
    Volkswagen Races Toward Next-Gen Automotive Manufacturing Leadership With Google Cloud And T-Systems
    • September 19, 2023
  • 8
    VMware Scales Multi-Cloud Security With Workforce Identity Federation
    • September 18, 2023
  • Intel Innovation 9
    Intel Innovation 2023
    • September 15, 2023
  • Private 10
    A Comeback For Private Clouds
    • September 14, 2023
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
  • 1
    Microsoft And Oracle Expand Partnership To Deliver Oracle Database Services On Oracle Cloud Infrastructure In Microsoft Azure
    • September 14, 2023
  • 2
    Real-Time Ubuntu Is Now Available In AWS Marketplace
    • September 12, 2023
  • 3
    IBM Brings Watsonx To ESPN Fantasy Football With New Waiver Grades And Trade Grades
    • September 13, 2023
  • 4
    NASA Shares Unidentified Anomalous Phenomena Independent Study Report
    • September 14, 2023
  • 5
    Introducing OpenAI Dublin
    • September 14, 2023
  • /
  • Technology
  • Tools
  • About
  • Contact Us

Input your search keywords and press Enter.