docs and notes