NAME

Dist::Zilla::Plugin::JSAN::GitHubDocs - a plugin for Dist::Zilla which updates the 'gh-pages' branch after each release

VERSION

version 0.04

SYNOPSIS

In your dist.ini:

[JSAN::GitHubDocs]
extract             = doc/html          ; default value
redirect_prefix     = doc/html          ; default value
push_to             = origin            ; default value

DESCRIPTION

After release, this plugin will extract the documentation from the tarball, using the 'extract' parameter to the 'gh-pages' branch of your repo. Then it will push the updates to the "push_to" remote.

The documentation then will be available as

http://your_lowercased_github_user_name.github.com/Your-Dist-Name 

The plugin will add the "index.html" file, which redirects the user from the link above to the documentation of the main module (using 'redirect_prefix' parameter):

http://your_lowercased_github_user_name.github.com/Your-Dist-Name/doc/html/Your/Dist/Name.html

AUTHOR

Nickolay Platonov <nplatonov@cpan.org>

COPYRIGHT AND LICENSE

This software is copyright (c) 2010 by Nickolay Platonov.

This is free software; you can redistribute it and/or modify it under the same terms as the Perl 5 programming language system itself.