clarify upload design
schmas: more updates from pull request feedback