viewdocs :: index

Welcome to Viewdocs

Viewdocs is Read the Docs meets Gist.io for simple project documentation. It renders Markdown from your repository's docs directory as simple static pages.

Getting Started

Just make a docs directory in your Github project repository and put an index.md file in there to get started. Then browse to:

http://<github-username>.viewdocs.io/<repository-name>

Any other Markdown files in your docs directory are available as a subpath, including files in directories. You can update pages by just pushing to your repository or editing directly on Github. It can take up to 1-2 minutes before changes will appear.

This page is an example of what documentation will look like by default. Here is another example page. The source for these pages are in the docs directory of the Viewdocs project.

Preview changes before pushing documentation back the repository

If you want to find out how things look like locally before pushing your code back to the remote repository, you might want to try out previewdocs.

Advanced Usage

You can show documentation for different branches or tags of a repository by including a reference name after a tilde in the repository part of the path. It would look like this:

http://<github-username>.viewdocs.io/<repository-name>~<refname>

You can also customize the look and layout of your docs. Make your own docs/template.html based on the default template and your pages will be rendered with that template.

I also highly recommend you read the source to this app. It's less than 200 lines of Go. If you want to hack on Viewdocs, check this out.


Enjoy!
Jeff Lindsay