Better resource type development documentation

Documentation needs to updated to help east difficulty in resource type development. Reports of :

- There have been many instances where a given resource will work locally but fail when executed in AWS.
- on a Read the resource will only get the primaryIdentifier , property must be returned by Read to work with Fn::GetAtt.
- CFN enforces physical identifiers across stacks for registry resources.