added notes to providers docs