Better document and explain ``package_id``

[memsharded]

There is very little at this moment about the package_id, why it is important, what information does it contain, etc.