doc: document current conventions on package naming

Mostly: encourage using dashes instead of underscores.