some more explanations + typo fix in Resource docs