Pipeline Step Documentation Generator improvements

This project aims to improve the Pipeline Steps Reference that is generated automatically with the help of the plugin manager associated with a mock Jenkins instance. The improvements will lead to a smoother user experience and better usability of the generated documentation.

Documenting the Pipeline steps is not an easy task. Currently, there are more than 600 plugins that provide 1500+ steps for use within a Pipeline script. Furthermore, these steps have several parameters that may be used along with them. All these steps are documented in the Asciidoc format, which is autogenerated in a specified format by a Java program.

Although the Pipeline Snippet Generator is the best way to understand how a step should be used, there are two reasons why documenting all the steps is necessary.

So, to work with documentation of this magnitude, it is required that we generate and format it so that the user can find the piece of information they are seeking effectively. Thousands of Pipeline developers all over the world will benefit from improvements in the same.

The implementation revolves around two major changes.

Apart from these changes, minor changes will be done to refactor the code and remove anomalies from the steps documentation. Also, the instructions regarding the snippet generator will be included in the documentation template to promote its usage.