(GH-225) Add custom_insync to rsapi docs

This commit coincides with the work for puppetlabs/puppet-resource_api#225
to add the new custom_insync feature and functionality to rsapi resources;

It covers a common use case in the code and explains the purpose and some
implementation concerns.

Author: michaeltlombardi