[TASK] Document @api and rewrite some docblocks