Proposal for numbering examples for cross-referencing

[andrea-perego]

I would suggest we number examples in the DCAT spec, so that they can be both cross-referenced inside the spec, and linked to from external documents.

If this makes sense, I can start and give it a try. There's also a script we used in the SDW BPs that can take care of creating the cross ref text automatically (as we do for sections with class sectionRef):

https://github.com/w3c/sdw/blob/6f532fc04ff55fead8278f5d46984830185c2a0d/bp/index.html#L9

This way the example number in the cross ref text will be dynamically inferred, and needn't be hard-coded.

Also noting the relevant feature request to ReSpec: https://github.com/w3c/respec/issues/1124

[andrea-perego]

Proposed revision in PR #674

NB: I have not included yet the SDW BP script I mentioned above.

[davebrowning]

That's all been merged, @andrea-perego, and looks pretty good even just from a layout perspective. If you get a chance to add the script then that would make it more useful (I don't fancy renumbering links every so often....)

[andrea-perego]

Thanks, @davebrowning . I'll take care of creating the relevant PR.

[davebrowning]

Done.