Documentation/How-to template

= Walkthroughs, how to's and tutorials =

This document provides a simple template that can be used as a starting point for technical documentation that are intended to walk readers through the steps of using and setting up a particular tool or software.

Who should use this template?
This template isn't suitable for all forms of documentation, you should only use this document as a guide/starting point for your documentation if;


 * You want to provide a detailed step to step explanation of a software or tool.
 * Your documentation is for people of all skill levels(beginners inclusive).
 * You intend to provide sufficient code samples, diagrams, and workflows where necessary.

= Template = The below is the provided template for this particular genre and is to be duly followed when creating documentations.

= How To Install/Setup/Configure Software X = The title of the documentation should be written boldly at the top, shouldn't be too long or vague. The title should be naturally sufficient to give enough context to what the article is about. You can read more about choosing the right title in the Article titles, headings, and sections here.

Introduction
This part should provide adequate information about what this documentation is about, what will the reader learn?

What approach did you take in explaining this concept?

What will the reader be able to do after reading this documentation?

In this tutorial, we would be setting up X and I would walk you completely through the setup....

By the end of this tutorial, you would be able to do X in Y way using Z...

Prerequisites
Some documentation require domain specific knowledge which would not be discussed in the tutorial, such prerequisite knowledge should be explicitly stated with links pointing to useful resources where this prerequisite knowledge could be acquired. More explicitly, you shoud look out for and/or add the following to prerequisites of your documentations.


 * Software requirements
 * Which operating system and what version is required for this tutorial?
 * Which additional software installation is needed?
 * Which specific tools do your audience have to be familiar before proceeding?
 * Where do they learn how to install each of the above?
 * Hardware requirements
 * Are there any hardware requirements?
 * What's the minimum RAM requirements in which this setup can run on?

Example

This tutorial requires atleast Node Erbium(v12.x.x) and npm version 6.12.0. You're expected to run atleast Ubuntu 18.04 with a minimum of 8gb RAM.

Follow the instructions here to learn how to install Node JS on Linux.

The examples in this tutorial run on a docker container, you need to have mediawiki docker setup locally. Follow the instructons here to set it up.

Installation
- Linux

- Windows

- Mac

Code Samples - API:Documentation template