update documentation for I/O specification in app metadata

[keighrim]

New Feature Summary

For main audience of app developers, I want the API documentation to include detailed instruction on how to write a good I/O specification using recently added features in app metadata schema.

Related

Recently added features;

• added methods that allows additional type-level descriptions #202
  • see a metadata/property for all annotation types for documentation for human readers mmif#225) for output examples
  • adding description field as a sibling to @type to allow devs to add documentation for a specific type use case.
  • see https://github.com/clamsproject/mmif/pull/226/files for abandoned prose
• support for "map" typed runtime parameter #197
  • detailed examples are in the issue body and comments
• at_type property value specification for collections in app metadata  #194 (comment)
  • added "*" wildcard notation for underspecified prop values

Alternatives

No response

Additional context

No response