W3C home > Mailing lists > Public > public-dxwg-wg@w3.org > January 2019

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

From: Andrea Perego via GitHub <sysbot+gh@w3.org>
Date: Sat, 19 Jan 2019 16:18:37 +0000
To: public-dxwg-wg@w3.org
Message-ID: <issues.opened-401010123-1547914716-sysbot+gh@w3.org>
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

This archive was generated by hypermail 2.3.1 : Monday, 25 March 2019 10:33:29 UTC