Maint: Improve documentation of file type's source parameter
This commit tightens up the huge description of the source attribute, by:
- Explaining the recommended puppet URI format instead of the complete format
- Fixing a misleading example to use puppet URIs instead of local files
- Calling out the source/content/target trichotomy
- Inserting an example of how module layout maps to puppet URIs