couple of doc developer changes and notes