A dedicated section for links
m-mohr opened this issue · 2 comments
I was just looking for a dedicated section that describes the concept (and schema) of a link in OGC API - Feature - Part 1.
More specifically, I was looking for the link schema in GeoJSON and the first clickable link to the schema is in 7.10. String internationalization, which is rather weird.
The term link is generally used various times throughout the document, but the actual information about links (schemas, relation types, ...) are scattered around.
Examples:
- 5.2. Link relations
- 7.12. Link headers
- 7.10. String internationalization
-
- Requirements classes for encodings
I think it would be gread if there would be a central section that describes the specifics of the links:
- RFC 8288 dependency
- Schemas for the encodings
- Use of relation types
- etc.
It might just be a summary somewhere at the beginning with links to the corresponding sections, but I think a central place that people can link/point to would be good.
Edit: Common has something similar: https://docs.ogc.org/is/19-072/19-072.html#_11b9b4f7-42fc-413a-b63a-e7fb060b5e4b
Good point @m-mohr.
This belongs to clause 7 (not the conventions clause), so we could change the "Link headers" sub-clause to discuss also the other web linking aspects and rename it to "Links".
This should then also be moved forward to appear before the "String internationalization" sub-clause. Since the Landing Page also discusses links it should probably be directly after 7.1 "Overview" and before the "API landing page" sub-clause.