documentation of resources should be done in ruby via desc next to the type. The readme should not need to have detailed description of each resource type.