search

w3c / sdw

Repository for the Spatial Data on the Web Working Group
https://www.w3.org/2020/sdw/
148 stars 81 forks source link

SDWBP document formatting is off-putting #1248

Open dr-shorthair opened 3 years ago

dr-shorthair commented 3 years ago

Readers are finding it hard to make sense of the BP document because of the way that examples and elaborations are nested in coloured boxes inside the differently coloured boxes for the best practices. Could each actual best pracice be succinctly packaged in an orange box, and the elaborations and examples presented separately?

andrea-perego commented 3 years ago

@dr-shorthair said:

Readers are finding it hard to make sense of the BP document because of the way that examples and elaborations are nested in coloured boxes inside the differently coloured boxes for the best practices. Could each actual best pracice be succinctly packaged in an orange box, and the elaborations and examples presented separately?

Tentative fix in PR https://github.com/w3c/sdw/pull/1247

For a preview, see https://raw.githack.com/w3c/sdw/bp-issue-1084/bp/index.html#globally-unique-ids