bom + doc fixes