Improve the API documentation for the Party class.

Signed-off-by: Aron Cedercrantz <aron@cedercrantz.se>