enhance compensation documentation

Enhance userguide about compensation. I think an "it" should be added.