minor doc and notes