What makes a 'best' best practice?

Hi-

Many thanks for the references to your favourite (technical) documentation
examples [1].

I've summarised the key points [2] - there are some pretty clear things
that we need to do ... and some questions too (for example- about
publishing working examples and other resources that are as durable as the
W3C needs).

Happy to discuss on the call today or via email. Please advise if
a) I have missed anything that you regard as a "must have"
b) there's anything that you see as a "don't do that"

Regards, Jeremy

[1]: https://www.w3.org/2015/spatial/wiki/BP_Structure_Examples
[2]:
https://www.w3.org/2015/spatial/wiki/BP_Structure_Examples#Summary_points