I'm still continuing to look at all of the functionality of apipie, but I think it will be the doc library that we wind up using. I am wondering if you have any suggestions for the following, though.
If none of this is possible and you think they are good features, let me know how you think it should be designed and implemented, and I will try to get to it myself. Thanks again!
For extedning the controller, you should be able to do something like this somewhere in initializers of your app
# your custom code goes here
To override some views, copy them (just those ones you want to alter) to your app app/views/apipy/apipies dir, when rendering, a view from this one should take precedence over the original one.
The 5. point is a good suggestion. Maybe diffing the json output for different versions is a good start to see what changed. It would be nice if Apipie was able to preproces that. We will need it at some point as well.
Did that answer your guestions?
Yep this is perfect! I'll look in to writing a patch for a 'changes' directive to see what you think about it. It would benefit us greatly as we won't have to maintain an external document saying what has changed in between REST api versions :)