http://apiary.io/
This or something like it might be a good way to document out RESTful api's? I have not done more than just a quick look, but perhaps there is something there that could be useful.
Thoughts?
-Jay