Miki/update donations api doc

@raypereda @DavidHuie Please review.

I did my best to fill in the descriptions but those marked with TODO are still missing.