disable notes with clarification
update documentation