api doc and user resource upgrades

see commit logs