heroku/prmd — pull request #90 by mmcgrana (2014-04-14 19:26:12+00:00)
Title: provide guidance on directory structure/location

This provides a couple key benefits:

1. Better interop, as you'll be able instantly to find the this in any participating project.
2. Defaulted args, ie could use meta automagically if it followed convention.

Suggestion:

* /schema
* /schemata
* {resource}.json (individual resource schema)
* ...
* meta.json (required, provides root url and defaults for init)
* overview.md (optional, prepended to docs)
* schema.json (optional, combine output)
* schema.md (optional, doc output)