doc about how to approach state of resources