packages: Adding comments

Commit 7d80039577c9f6365637d5c29d4fa511d42cec47 was lacking of comments.
Let's add some to get the code easier to read