SDWBP document formatting is off-putting

[dr-shorthair]

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]

@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 #1247

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