update docs for promise type
markup extended attribute names better
merge