doc: document current conventions on package naming

Mostly: encourage using dashes instead of underscores.
Merge pull request #1815 from vcunat/p/doc-package-naming

doc: document current conventions on package naming