Moved some of the parts of the spec to the first section addressing several issues:
21 while the topic was mentioned directly, it was in a place related to API Documentation
13 moved rules of external resources handling from IRI Template section to first part of the document
61 volatility of the API documentation was mentioned stronger
More details
While most of the things mentioned in the issues enlisted above were addressed, places where those topics were covered were related to other terms of the vocabulary. I've moved those parts to the paragraph 4.1 Adding Affordances to Representations and reworded them to achieve more generic rules.
Summary
Moved some of the parts of the spec to the first section addressing several issues:
21 while the topic was mentioned directly, it was in a place related to API Documentation
13 moved rules of external resources handling from IRI Template section to first part of the document
61 volatility of the API documentation was mentioned stronger
More details
While most of the things mentioned in the issues enlisted above were addressed, places where those topics were covered were related to other terms of the vocabulary. I've moved those parts to the paragraph 4.1 Adding Affordances to Representations and reworded them to achieve more generic rules.