[dxwg] Proposal for numbering examples for cross-referencing (#673)

andrea-perego has just created a new issue for https://github.com/w3c/dxwg:

== Proposal for numbering examples for cross-referencing ==
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

Please view or discuss this issue at https://github.com/w3c/dxwg/issues/673 using your GitHub account

Received on Saturday, 19 January 2019 16:18:38 UTC