docs: add notes