Add description to promotion adjustments

Currently promotion adjustments don't have a description.
This PR makes it possible to pass Promotion descriptions to these adjustments.
Fixed typos/PHPDoc
Merge pull request #512 from Richtermeister/promotion-descriptions

Add description to promotion adjustments