improved documentation
more resource design notes
design notes on resource parsing/building and unwrapping values