update documentation
include resource instantiation