Revert "Revert "add notes""

This reverts commit de4cc0bca3d25e9e06cec181afff54ebc21d514a.