We are using Slate to power our RPC documentation. For generating markdown use:
go get github.com/davecheney/godoc2md
# from root of this repo
make rpc-docs
Requests that return multiple items will be paginated to 30 items by default. You can specify further pages with the ?page parameter. You can also set a custom page size up to 100 with the ?per_page parameter.