adding docs and notes to make this more functional;