added some notes for the docs