Update the policy documentation for sync and local sync.

components/policy/resources/policy_templates.json

 {
 # policy_templates.json - Metafile for policy templates
 #
 # The content of this file is evaluated as a Python expression.
 #
 # This file is used as input to generate the following policy templates:
 # ADM, ADMX+ADML, MCX/plist and html documentation.
 #
 # Policy templates are user interface definitions or documents about the
 # policies that can be used to configure Chrome. Each policy is a name-value
@@ skipping 1516 matching lines @@
       'example_value': True,
       'id': 20,
       'caption': '''Disable synchronization of data with Google''',
       'tags': ['filtering', 'google-sharing'],
       'desc': '''Disables data synchronization in <ph name="PRODUCT_NAME">$1<ex>Google Chrome</ex></ph> using Google-hosted synchronization services and prevents users from changing this setting.
 
       If you enable this setting, users cannot change or override this setting in <ph name="PRODUCT_NAME">$1<ex>Google Chrome</ex></ph>.
 
       If this policy is left not set Google Sync will be available for the user to choose whether to use it or not.
 
-      To fully disable Google Sync, it is recommended that you disable the Google Sync service in the Google Admin console.''',
+      To fully disable Google Sync, it is recommended that you disable the Google Sync service in the Google Admin console.
+
+      This policy should not be enabled when <ph name="ROAMING_PROFILE_SUPPORT_ENABLED_POLICY_NAME">RoamingProfileSupportEnabled</ph> policy is set to enabled as that feature shares the same client side functionality. The Google-hosted synchronization is disabled in this case completely.''',
       'arc_support': 'Disabling Google Sync will cause Android Backup and Restore to not function properly.',
     },
     {
       'name': 'RoamingProfileSupportEnabled',
       'type': 'main',
       'schema': { 'type': 'boolean' },
       'supported_on': ['chrome.win:57-'],
       'features': {
         'dynamic_refresh': False,
         'per_profile': False,
       },
       'example_value': True,
       'id': 358,
       'caption': '''Enable the creation of roaming copies for <ph name="PRODUCT_NAME">$1<ex>Google Chrome</ex></ph> profile data''',
       'tags': ['local-data-access'],
       'desc': '''If you enable this setting, the settings stored in <ph name="PRODUCT_NAME">$1<ex>Google Chrome</ex></ph> profiles like bookmarks, autofill data, passwords, etc. will also be written to a file stored in the Roaming user profile folder or a location specified by the Administrator through the <ph name="ROAMING_PROFILE_LOCATION_POLICY_NAME">$1<ex>RoamingProfileLocation</ex></ph> policy.
 
-      Google Sync is automatically disabled when this policy is enabled.
+      If this policy is disabled or left not set only the regular local profiles will be used.
 
-      To prevent accidental data leaks it is advisable to also set the <ph name="SIGNIN_ALLOWED_POLICY_NAME">$1<ex>SigninAllowed</ex></ph> policy to False.
-
-      If this policy is disabled or left not set only the regular local profiles will be used.''',
+      When roaming profiles support is used the <ph name="SYNC_DISABLED_POLICY_NAME">SyncDisabled</ph> policy should not be enabled because the support for roaming profiles relies on the same client side functionality. The Google-hosted synchronization is disabled in this case completely.''',

[Andrew T Wilson (Slow), 2017/06/14 15:05:44]

I guess I find "Google-hosted synchronization" confusing, since roaming profile
support doesn't feel like "Google-hosted synchronization".

Maybe up above it should say something like "SyncDisabled disables all data
synchronization, overriding RoamingProfileSupportEnabled"?

Somewhere in this documentation it should be made clear that setting
RomaingProfileSupportEnabled=true will disable cloud sync.

[pastarmovj, 2017/07/03 11:14:58]

Finally came around to addressing this. I like the suggestion it makes it
cleaner and down to the point. :)

       'label': '''Enable the creation of roaming copies for <ph name="PRODUCT_NAME">$1<ex>Google Chrome</ex></ph> profile data.''',
     },
     {
       'name': 'RoamingProfileLocation',
       'type': 'string',
       'schema': { 'type': 'string' },
       'supported_on': ['chrome.win:57-'],
       'features': {
         'dynamic_refresh': False,
         'per_profile': False,
@@ skipping 8119 matching lines @@
       'desc': '''Text appended in parentheses next to the policies top-level container to indicate that those policies are of the Recommended level''',
       'text': 'Default Settings (users can override)',
     },
     'doc_complex_policies_on_windows': {
       'desc': '''Text pointing the user to a help article for complex policies on Windows''',
       'text': '''encoded as a JSON string, for details see <ph name="COMPLEX_POLICIES_URL">https://www.chromium.org/administrators/complex-policies-on-windows<ex>https://www.chromium.org/administrators/complex-policies-on-windows</ex></ph>''',
     },
   },
   'placeholders': [],
 }