better resource handling w/ bracket, syntax/docs cleanup