Re: Referencing UCR requirements in other documents: not by number

Good point, I'll fix those soon.

On 27 September 2016 at 20:17, Frans Knibbe <frans.knibbe@geodan.nl> wrote:

> Hello,
>
> A note for everyone (especially document editors) referencing requirements
> from the Use Cases and Requirements document: When reading the draft of the
> note Publishing and Using Earth Observation Data with the RDF Data Cube
> and the Discrete Global Grid System <http://w3c.github.io/sdw/eo-qb> I
> noticed that requirements in the UC&R document are referred to by number,
> e.g. [Req 5.40 <https://www.w3.org/TR/sdw-ucr/#SpatialMetadata>]. I would
> like to point out that fragment identifiers (e.g. #SpatialMetadata) can be
> considered stable, but the numbering of the requirements is not. Section
> numbering is handled by ReSpec and can change when requirements are added
> or removed. So it is better to refer to them by their title, which should
> be short enough. For example: Spatial metadata
> <http://w3c.github.io/sdw/UseCases/SDWUseCasesAndRequirements.html#SpatialMetadata>
> , spatial metadata requirement
> <http://w3c.github.io/sdw/UseCases/SDWUseCasesAndRequirements.html#SpatialMetadata>
> .
>
> Regards,
> Frans
>
>
>
>
>

Received on Tuesday, 27 September 2016 10:23:38 UTC