[DOC, COMMENT] Adds documentation entry for DynamicGaps. Corrects some comments.
Merge pull request #425 from rrahn/feature/dynamic_gap_costs

[DOC, COMMENT] Adds documentation entry for DynamicGaps. Corrects some comments.