Improve metadata documentation.
Document the property paramter for metadata.

Also some other miscellany, such as noting the fact the example response
may not exactly match real output (due to feature-lackin').