Details
-
Type:
Task
-
Status:
Closed
-
Priority:
Major
-
Resolution: Won't Fix
-
Affects Version/s: 2.0, 2.1, 2.2
-
Fix Version/s: 2.3-M1
-
Component/s: coverage, geometry, metadata, referencing
-
Labels:None
-
Number of attachments :
Description
GeoAPI tries to stick to OGC/ISO standards as much as possible. But in some area it took a slight departure. Some of those departures are documented there:
http://geoapi.sourceforge.net/snapshot/javadoc/org/opengis/annotation/doc-files/departures.html
A list generated automatically from the annotations is there:
http://geoapi.sourceforge.net/snapshot/javadoc/org/opengis/annotation/doc-files/departures-list.html
This list needs to be updated with more departures pointed-out by users on the mailing list. This task is an umbrella for sub-tasks specific to some significant departures. This list should be formatted as an annexe attached to a document to be submitted to OGC.
Proposal: define a new @departure javadoc tag and use it for documenting the departure in place. We can search the existing @issue tag on the codebase for finding the departures that are already documented and retrofit them in the new javadoc tag.