note: doc updates