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)