add docs about comments