Lint errors

This PR updates the resource descriptors document to include a new top level property called 'descriptor_type'.  It currently may be "resource" or "error" with it defaulting to "resource".  In the future I would like to support "partial" to allow descriptors documents to share descriptor elements.
Maybe just change the description to `...even if the --strict option is set` for clarity, then. :)