@komidore64, it was probably my mistake to include names of views/partials in this document.  I suggest to remove it.  The purpose of view/partials is to keep things DRY (Don't Report Yourself).  It is not important for API documentation.  Instead of writing ```attributes :id, :name``` for an object in a bunch of places, it's DRYer to write ```extend 'api/v2/object_name/base'.  However, the JSON response and documentation is the exact same.  Additionally, API is **not** a full exposure of the database.  Not all db fields need to be exposed in the API, and not all names need to match the db names.