Added doc comments and updated TODO

Signed-off-by: Olli Vanhoja <olli.vanhoja@ninjaware.fi>