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;

• https://github.com/clamsproject/clams-python/issues/202
  • see https://github.com/clamsproject/mmif/issues/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
• https://github.com/clamsproject/clams-python/issues/197
  • detailed examples are in the issue body and comments
• https://github.com/clamsproject/clams-python/issues/194#issuecomment-1974983541
  • added "*" wildcard notation for underspecified prop values

Alternatives

No response

Additional context

No response