DEV Community: Ujah Emmanuel

Changing Careers & FOMO

Ujah Emmanuel — Fri, 03 Jun 2022 04:50:31 +0000

Do I have FOMO(fear of missing out)if I change careers after 6 months of learning?

What's your take on this...

All feedback is appreciated 👍

How to Switch Between Node Versions on Windows

Ujah Emmanuel — Mon, 11 Apr 2022 04:03:14 +0000

Introduction

we build projects based on a specific version of tools, dependencies, and packages. And quite often, these tools and packages get updated. What happens when you need to work on a project that requires a previous version of Node? Do you have to uninstall the current version and install the version you need? what happens after you finish working on the project?

In this post, I will share how you can switch between multiple versions of Node and manage your projects easily using Node Version Manager(NVM) on windows.

As developers, we work on many projects that run on different versions of packages. I recently had a similar challenge where my system is running Node v 16.14.2 which is the latest version at the time, and the project I want to work on required Node v 16.8.0. Hence, the motivation for writing this article.

Node Version Manager (NVM)

Node Version Manager (NVM) is a tool that allows developers to easily switch between multiple node versions without having to manually uninstall and install a new version anytime the need arises. Just as the name implies, nvm manages our Node version.

Installing NVM on Windows

Now before you install NVM, be sure to uninstall any existing installation of Node from your system to avoid complications during installation. Head over to Github and download nvm-setup.zip from the list of available options and follow through a regular installation process, nothing new.

TL;DR

Further information on installing NVM on windows can be found here.

After successfully installing NVM, open up your terminal and enter the following command

nvm help

If the installation was successful, you should get a response like the image below.

Installing Node.js using NVM on Windows

The next step after installing NVM is to install Node. NVM makes it very easy to install multiple versions of Node with a single command. Before we proceed, it is important to note that NVM requires a level of permission to make changes to your system. Open up PowerShell as an administrator and enter the following command to install Node.

nvm install lts

The above command installs the current and most recent LTS version of Node. Optionally, you can install "latest" for the latest version available. To install an older version of Node, specify the version number with the command nvm install <version-number>

nvm install 8.17.0

Let's install an even older version, so we can see clearly how easy it is to switch and manage these different node versions.

nvm install 6.5.0

If everything works correctly, you should have three (3) versions of Node installed onto your system. Let's confirm this by entering the next command in the terminal.

nvm list

The nvm list command displays a list of all installed node versions and specifies the currently active version.

Switching Between Node.js Versions

By default, your system should be running the first version of Node you installed. In my case, it would be Node v16.14.2 which is the LTS version at the time. To use any of the available versions, enter the next command nvm use <version>.

nvm use 6.5.0

You should get the following response.

Alternatively, you can enter the following command nvm current to see the currently active version.

It is also important to note **that each Node version you install automatically comes with a **node package manager(npm) that is compatible with the Node version.

Uninstalling a Node.js Version

To uninstall a Node version, enter the command nvm uninstall <version>.

nvm uninstall 6.5.0

That's as easy as it gets when using NVM. There are more options you can explore when you run the nvm help command. But I don't want to bore you with that information.

Conclusion

NVM makes switching between Node versions a seamless experience. Hope you are able to set up and use NVM to manage Different Node versions on your system. If you found this post useful, you can live a like and share. Connect with me on Twitter for more content like this. That would be all for now, see you in the next one.

Effective Software Documentation*

Ujah Emmanuel — Tue, 05 Apr 2022 10:13:03 +0000

Introduction

The primary goal of every software product is for it to be successful and a huge percentage of that success depends on how well the documentation is designed. In fact, a well-built software product without decent documentation is as good as nothing. The success of a software product depends more on how comprehensible and detailed the documentation of that software is, and not just the code.

In this article, I will discuss software documentation in regards to types, best practices, tools for building, and the importance of documentation.

Eric Holscher the co-founder of Write the Docs once said, "Documentation is one of the most important parts of a software project. However, a lot of projects have little or no documentation to help their (potential) users use the software".

What is Software Documentation?

Software documentation refers to any written document that provides users with information such as; the processes involved in building a particular software, why a piece of software was built, what it does, how it works, and basically how it can be used in a clear and easy to comprehend approach.

Incorrect documentation is often worse than no documentation - Bertrand Meyer

Most times, users of a software product usually find themselves in the documentation only when the need arises. They are often in a haste to quickly find information that solves their problem. If the user finds the documentation complex, poorly structured, and inconsistent, they will easily ditch the service or product for an alternative. As a result, the availability of documentation is not enough. The content of the documentation has to be given the highest priority and delivered in a strategic approach in a way that the user can easily grasp.

Software documentation should be nothing short of elegance and effective because bad documentation can also hurt your software product even more than when there is no documentation. Bad documentation can lead to scaring away potential clients, losing existing clients, and wasting internal resources.

Types of Software Documentation

Software documentation is divided into two main categories, which are:

Process documentation
Product documentation

Process documentation refers to a document that describes the processes involved in building and maintaining a software product.

Product documentation is a document that basically describes a software product and provides information such as software requirements, how-to guides on different use cases of the software, terminologies, and concepts used in the software.

There isn’t one thing called “documentation” but four things known as documentation and they represent different purposes. According to Daniele Procida, the structure of good documentation is broken down into four quadrants which are; tutorials, how-to guides, explanation, and reference.

The documentation system ~ Daniel Procida

Tutorials (learning-oriented)
How-to guides (problem-oriented)
Explanation (understanding-oriented)
Reference (information-oriented)

Software documentation delivered in this format makes it easier to maintain and update and also on the part of end-users, navigation and search for information in the documentation becomes a seamless experience.

Best Practices

Explicitly Structured: The structure of documentation really matters a lot, because it determines how users can navigate and access information quickly; Delivering documentation following the tutorials, how-to guides, explanation, and reference structure makes it easy for users to navigate and find information quickly.
Consistency: Good documentation is consistent with information covering all aspects of the software use cases and without gaps.
Up-to-date: The documentation of software should evolve according to the changes in the software, to capture all changes and remain consistent.
Clear and Inviting: Users always look for documentation that is clear and easily comprehensible.
Sample Code: Good documentation should provide code examples for various use cases of the software, so users can see key concepts in action.
Know your Target Audience: Identify and evaluate different personas for your software and curate documentation that is appealing to their various use cases.
User Experience: Good documentation should consider the users' experience of the software documentation and also should be as inclusive as possible.
The documentation should be scannable, easy to find, and contribute to.

Documentation tools

There are various tools for creating software documentation; some of the popular ones are GitHub, Read The Docs, Docz, Docusaurus, Dropbox Paper, Documize, etc. You can use whichever tool you feel comfortable with, having in mind that they all have their ups and downs.

Importance of effective documentation

Some of the benefits of good software documentation are as follows;

Sustains Open Source Software: The success of an open source software depends on the strength of the community behind it, effective documentation enables contributors to use and contribute to the software and this ensures growth, maintainability, and scalability.
Content Marketing: Good software documentation serves as a form of an advert for your software because it makes your software appealing and easier for intending users to comprehend the various use cases for your software.
Saves Time and Effort: Decent documentation saves time and effort for both developers and end-users of your product.
Makes Hiring and Onboarding so much easier: It simplifies, the hiring and onboarding of new members because all necessary information relating to process, product, and the company is made available.
Cuts down Duplicate Tasks: The issue of having to reinvent the wheel or creating something that already exists is handled by good documentation.
Defines your product: Documentation summarizes important information about your software such as what the product does, how it works, and other essential details about the software

Conclusion

The success of a good software product depends not just on the code and the functionalities behind it but also on the documentation of that software. Writing documentation has to be strategic and follow best practices in other to avoid bad documentation.
The goal of Documentation doesn’t have to be “Just documentation” but effective documentation.

To recap, we discussed what software documentation is, types, best practices, tools for creating documentation, and the importance of effective software documentation.

If you find this article useful you can give it a like and share, and also, you can follow me on Twitter for more content like this. Thanks 🙌 and see you in the next one.