(maint) Remove excess comments

Prior to this commit, all of the PuppetDB tests had left over comments
still remaining in the code. This commit removes those comments. It also
adds more descriptive comments in the helper.