One rule for documentation I'd propose is that we don't require anybody to do anything that we don't have documentation for. 😊
For example, if we're going to require namespaces in packages, then we better damn well link to a place that explains how to do it. Why would be nice as well. (I have started documentation on this particular item)