Closed andrea-perego closed 3 years ago
Looks good and careful so far.
I do worry that the multiple coloured nestings within the document are a distraction for readers. Could it be changed so that an actual best practice is stated in one box, which is then closed. Then the elaborations and examples follow it, rather than being nested within it. That way the reader does not find themselves interminably scrolling through one 'best practice'. I realise that this is a whole-of-document issue, but at the moment it looks like a bit of a mess. I find it difficult to even get my team to read it because it looks so confusing.
Looks good and careful so far.
Thanks, @dr-shorthair .
I do worry that the multiple coloured nestings within the document are a distraction for readers.
Indeed. This is one of the side-effects of the ReSpec BP styling I was referring to.
I made an attempt to fix this with the last commit - see, e.g.:
https://raw.githack.com/w3c/sdw/bp-issue-1084/bp/index.html#globally-unique-ids
WDYT?
That is a big improvement
Revision prepared as discussed during the last SDW call: https://www.w3.org/2021/02/04-sdw-minutes.html
Relevant issue: https://github.com/w3c/sdw/issues/1084
Preview: https://raw.githack.com/w3c/sdw/bp-issue-1084/bp/index.html
Diff: https://services.w3.org/htmldiff?doc1=https%3A%2F%2Fw3c.github.io%2Fsdw%2Fbp%2F&doc2=https%3A%2F%2Fraw.githack.com%2Fw3c%2Fsdw%2Fbp-issue-1084%2Fbp%2Findex.html
NB: All revisions are explained in the HTML via EDNOTEs and in CSS and JavaScript code with comments.
Summary of revisions:
The BPs has been updated based on the new version of DCAT and GeoDCAT-AP, which include a more extended support for the description of spatial / temporal aspects - in particular, for the specification of bounding boxes, centroids, spatial and temporal resolution (see summary in https://lists.w3.org/Archives/Public/public-sdwig/2019Jul/0000.html).
The implemented revisions concern the following parts of the BP document:
More details are documented in the changelog.
Additional revisions (mainly editorial) include the following:
@id
to two examples to address issue https://github.com/w3c/sdw/issues/1037Finally, some fixes have been done based on the warnings raised by ReSpec:
respec-w3c
, asrespec-w3c-common
is now deprecated.@href
instead of using double square brackets.There are still some open editorial issues following updates to ReSpec:
SECTION
element is used for sections "Why", "Intended Outcome", etc.