Book Image

Grunt Cookbook

By : Jurie-Jan Botha
Book Image

Grunt Cookbook

By: Jurie-Jan Botha

Overview of this book

<p>A web application can quickly turn into a complex orchestration of many smaller components, each one requiring its own bit of maintenance. Grunt allows you to automate all the repetitive tasks required to get everything working together by using JavaScript, the most popular programming language.</p> <p>Grunt Cookbook offers a host of easy-to-follow recipes for automating repetitive tasks in your web application's development, management, and deployment processes. This book will introduce you to methods that can be used to automate basic processes and your favorite tools. By following the recipes, you will soon be comfortable using Grunt to perform a wide array of advanced tasks in a range of different scenarios.</p>
Table of Contents (17 chapters)
Grunt Cookbook
Credits
About the Author
About the Reviewers
www.PacktPub.com
Preface
Index

Adding documentation for a plugin


High-quality documentation is essential for the success of most software development projects. In the context of a Grunt plugin, its main purpose is to provide instructions and information on the usage of the plugin and its tasks. As with most projects hosted on GitHub, the documentation for a plugin is located in the README.md file, and written in the Markdown format.

Tip

For more information on the general Markdown format, you can visit the following URLs:

http://daringfireball.net/projects/markdown/

https://help.github.com/articles/github-flavored-markdown/

Getting started

In this recipe, we'll continue to work on the project we created in the Creating a plugin task recipe earlier in this chapter. Be sure to refer to it if you are not yet familiar with its contents.

How to do it...

The following steps take us through reviewing and adding to the documentation generated by Yeoman and the gruntplugin generator we used earlier.

  1. Let's start by using our favorite editor...