Utilities and VS Code Extensions to Make Developer’s Life Easier

Utilities and VS Code extensions to make developer’s life easier.

Photo by Peter Conlan on Unsplash

Overview

Technical writing is an essential skill. Having good project documentation helps people understand and use your software effectively. Even if you develop the code, after few months potentially the code is indistinguishable from code that someone else has written. If it is an open-source project and you want people to contribute, then you need to let them understand the code in order to help out.

This article explores utilities and VS Code extensions that could help us document our projects.

README

Let’s start with README. For GitHub-hosted projects, different markup formats are supported to write a README document (md, rst, rdoc, org, textile, etc). You can choose a markup language that you are comfortable with to get started.

There are generators available to help us write a better README.

Readme.so

Readme.so is an online editor to help developers make README for their projects.

Using the online editor, I can create a README file with the sections I need.