clarify some unique parts of the gem with comments [ci skip]