agent: port allocator comments
Merge pull request #79 from spotify/dano/port-allocator-comments

agent: port allocator comments