more documentation and placeholders for missing info