notes for documentation generation