Awesome
grunt-verb
Grunt plugin for Verb, the markdown documentation generator with zero-configuration required.
Other Verb tools:
- Get verb-cli to use Verb from the command line
- Get generator-verb to add documentation templates, or initialize docs for new projects
- Get gulp-verb for gulp workflows
Install with npm
npm install grunt-verb --save-dev
You can also use the Verb generator to kickstart the documentation for any project.
Please report any bugs or feature requests, thanks!
Examples
You can build any kind of markdown document with Verb, but building a readme is an easy way to get started.
Here is an example template for a basic readme:
# {%= name %}
> {%= description %}
{%= toc() %}
## Overview
{%= docs("overview") %}
## Options
{%= docs("options") %}
## Examples
{%= docs("examples") %}
## License and Copyright
{%= copyright() %}
{%= license() %}
Then add the task to your Gruntfile. Please note this requires no configuration as long as your documentation is OK:
grunt.loadNpmTasks("grunt-verb");
grunt.registerTask("default", ["verb"]);
Contributing
Find a bug? Have a feature request? Please create an Issue. If you find this project useful please consider "starring" it to show your support!
In lieu of a formal styleguide, take care to maintain the existing coding style. Add unit tests for any new or changed functionality.
Pull requests are also encouraged, please re-build the documentation with grunt-verb before you submit your pull request! Thanks!
Author
Jon Schlinkert
License
Copyright (c) 2014 Jon Schlinkert, contributors.
Released under the MIT license
This file was generated by grunt-verb on May 05, 2014.