docs; populate example
test; cleanup
fixed; pull / set subdoc combination

closes #1303