```js
/**!
 * grunt-readme
 * http://github.com/assemble/grunt-readme
 * Partially derived from and inspired by grunt-contrib-internal
 *
 * Copyright (c) 2013, Jon Schlinkert, contributors
 * Licensed under the MIT license.
 */
```
[View Source Code](https://github.com/assemble/grunt-readme/tasks/readme.js#L1-8)

```js
/**
     * options.metadata
     * @type {Object}
     */
```
[View Source Code](https://github.com/assemble/grunt-readme/tasks/readme.js#L53-56)

```js
/**
     * meta: {}
     * Root context object passed to templates with a value of "this"
     * @type {Object}
     */
```
[View Source Code](https://github.com/assemble/grunt-readme/tasks/readme.js#L60-64)

```js
/**
     * Convenience variables.
     */
```
[View Source Code](https://github.com/assemble/grunt-readme/tasks/readme.js#L73-75)

```js
/**
     * Templates directory.
     * If `options: { templates: '' }` is not defined, then the task will use the
     * templates directory in the `./templates` directory of the grunt-readme task.
     * @type {String}
     */
```
[View Source Code](https://github.com/assemble/grunt-readme/tasks/readme.js#L85-90)

```js
/**
     * Docs directory
     * The location where all of your docs will be stored
     * This defaults to './docs' in the root of your project.
     * @example:
     *   options: {
     *     docs: 'foo/'
     *   }
     */
```
[View Source Code](https://github.com/assemble/grunt-readme/tasks/readme.js#L99-107)

```js
/**
     * README template used to create README.md. Unless a template
     * is defined in the task options, a start template from
     * grunt-readme will be used.
     *
     * @example:
     *   options: {
     *     readme: './foo/README.tmpl.md'
     *   }
     */
```
[View Source Code](https://github.com/assemble/grunt-readme/tasks/readme.js#L131-140)

```js
/**
     * TRAVIS
     */
```
[View Source Code](https://github.com/assemble/grunt-readme/tasks/readme.js#L193-195)

```js
/**
     * CHANGELOG
     */
```
[View Source Code](https://github.com/assemble/grunt-readme/tasks/readme.js#L203-205)

```js
/**
     * CONTRIBUTING.md
     * Copy contributing guide from templates.
     */
```
[View Source Code](https://github.com/assemble/grunt-readme/tasks/readme.js#L213-216)

```js
/**
     * AUTHORS
     */
```
[View Source Code](https://github.com/assemble/grunt-readme/tasks/readme.js#L224-226)

```js
/**
     * Generate a Table of Contents
     * @usage: 
     */
```
[View Source Code](https://github.com/assemble/grunt-readme/tasks/readme.js#L237-240)

```js
/**
     * Generalized template configuration
     */
```
[View Source Code](https://github.com/assemble/grunt-readme/tasks/readme.js#L244-246)

```js
/**
     * Generate README
     */
```
[View Source Code](https://github.com/assemble/grunt-readme/tasks/readme.js#L253-255)