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.
Just make a
docs directory in your Github project repository and put an
index.md file in there to get started. Then browse to:
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
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:
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. If you create a
home.html template, this will be used for your project's landing page.
I also highly recommend you read the source to this app. It's less than 500 lines of Go. If you want to hack on Viewdocs, check this out.