Get unlimited access
Open in app
Home
Notifications
Lists
Stories

Write
IT Dead Inside
Published in

IT Dead Inside

Christopher Laine
Christopher Laine

Jun 16, 2019

·
7 min read
·

Self-documenting code is (mostly) nonsense

Your code isn’t as clear as you think it is, but there’s things you can do to help

Photo by rawpixel.com from Pexels

I just got through reading Cindy S Cheung’s great article on technical documentation and why devs need to explain their code better, and I have to say I completely agree.

--

--

More from IT Dead Inside

IT is a cesspool, but its home

Read more from IT Dead Inside

Recommended from Medium

Laiye

Laiye

How to Implement RPA in Banking & Finance?

Sébastien Dubois.

Sébastien Dubois.

in

JavaScript in Plain English

Mocking TS method overloads with Jest

Eric Christine

Eric Christine

CSS Basics Series: Responsive Web Design Using Media Queries

Aman Khan

Aman Khan

The Operating System very few people know😲.

Aman Khan

Aman Khan

How to set up a Django project with PostgreSQL on Docker?

Thomas Schwank

Thomas Schwank

How to read and store 600 addresses from an Allen Bradley PLC in 40 milliseconds using Python

Omar Faroque

Omar Faroque

in

Software System Design

System Design — How to query status of 10,000 machines

OpsMx Inc

OpsMx Inc

Spinnaker Operating Models

AboutHelpTermsPrivacy


Get the Medium app

A button that says 'Download on the App Store', and if clicked it will lead you to the iOS App store
A button that says 'Get it on, Google Play', and if clicked it will lead you to the Google Play store
Christopher Laine

Christopher Laine

Author, programmer, would-be philosopher. Author of Screens https://christopherlaine.net/screens

More from Medium

Justin Muench

Justin Muench

in

Better Programming

Why Do We Need RabbitMQ?

Mike Wolfe

Mike Wolfe

in

CodeX

Javascript CDNs and How To Use Them Offline

Adam Fisher / fisher king (@therightstuff)

Adam Fisher / fisher king (@therightstuff)

in

Towards Dev

Storing and Retrieving Unstructured DynamoDB objects in C# with the AWS SDK

Sebastian Rogers

Sebastian Rogers

Calling PnP JS from a TypeScript Azure Function: or a tale of two standards

Help

Status

Writers

Blog

Careers

Privacy

Terms

About

Knowable