doc update + marked some classes as @api