Skip to content
This repository

HTTPS clone URL

Subversion checkout URL

You can clone with HTTPS or Subversion.

Download ZIP

Documentation generation for RESTful APIs

branch: master

This branch is 0 commits ahead and 0 commits behind master

Fetching latest commit…

Octocat-spinner-32-eaf2f5

Cannot retrieve the latest commit at this time

Octocat-spinner-32 lib
Octocat-spinner-32 templates
Octocat-spinner-32 test
Octocat-spinner-32 .gitignore
Octocat-spinner-32 MIT-LICENSE
Octocat-spinner-32 README
Octocat-spinner-32 Rakefile
Octocat-spinner-32 init.rb
Octocat-spinner-32 install.rb
Octocat-spinner-32 uninstall.rb
README
Based on RAPI Doc by Jaap van der Meer found here: http://code.google.com/p/rapidoc/

Rails Api Doc Generator
Original Author: JPM van der Meer
Modified By: Chelsea Robb
=======================
With API DOC one can generate code for a Restful Rails API.
It generates a set of HTML views in the public directory.  Parses the desired controllers and generates appropriate views.
Currently does not read routes.rb and requires manual entry of routes

=INSTALL
    script/plugin install git://github.com/fmiopensource/rapi_doc

==Templates
Templates can be used for tuning your method generation and index.html.erb.

==Structure
In the structure folder one can setup some additional views to be used for the apidoc controller generator.

==Usage
Create a documentation.yml inside your config directory.  In this config file specify the controllers you wish to
generate documentation for in the following format:
users:
  location: "/users"
  controller_name: "users_controller.rb"

Then invoke the generation by calling:
    rake rapi_doc

==Documentation Example

=begin apidoc
url:: /users
method:: GET
access:: FREE
return:: [JSON|XML] - list of user objects
param:: page:int - the page, default is 1
param:: per_page:int - max items per page, default is 10

Get a list of all users in the system with pagination.  Defaults to 10 per page
=end

=======================
TODO  - Make class documentation work
      - Write tests and make them work
Something went wrong with that request. Please try again.