Ecosyste.ms: Awesome

An open API service indexing awesome lists of open source software.

Awesome Lists | Featured Topics | Projects

https://github.com/alfg/restful-markdown

:pencil: A simple style-guide for building RESTful documentation in Markdown.
https://github.com/alfg/restful-markdown

github markdown standard

Last synced: about 1 month ago
JSON representation

:pencil: A simple style-guide for building RESTful documentation in Markdown.

Awesome Lists containing this project

README

        

# restful-markdown

A simple style-guide for building RESTful documentation in Markdown, inspired by the [Github Developer API](https://developer.github.com/v3/).

There are so many ways to create documentation for your RESTful API. However, sometimes you just want something simple to publish along with your git repository. This project aims at utilizing [Github Flavored Markdown](https://help.github.com/articles/github-flavored-markdown/) to create a simple documentation of your RESTful API. No generators, compilers or any fluff, just Markdown.

Clone, fork, or just view the [examples](examples) directory for a documentation example.

## Resources

Resources to help with the style guide.

* http://restful-api-design.readthedocs.org/
* https://developer.github.com/v3/
* https://help.github.com/articles/github-flavored-markdown/

## Contribute

Contributions are welcome! Feel free to create an issue or pull request!

## License

[![CC0](http://i.creativecommons.org/p/zero/1.0/88x31.png)](http://creativecommons.org/publicdomain/zero/1.0/)

To the extent possible under law, [alfg](http://github.com/alfg) has waived all copyright and related or neighboring rights to this work.