This needs to describe the new process of namespacing that matches directory structure. You might get some ideas from my PR on namespaces for the platform: https://github.com/joomla/joomla-platform/issues/1787