policy_templates.json: Remove duplicate captions

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 955 matching lines @@
           'schema': { 'type': 'boolean' },
           'supported_on': ['chrome.linux:25-', 'chrome.mac:25-', 'chrome_os:42-'],
           'features': {
             'dynamic_refresh': True,
             'per_profile': False,
           },
           'example_value': False,
           'id': 285,
           'caption': '''Requires that the name of the local user and the remote access host owner match''',
           'tags': [],
-          'desc': '''Requires that the name of the local user and the remote access host owner match.
-
-          If this setting is enabled, then the remote access host compares the name of the local user (that the host is associated with) and the name of the Google account registered as the host owner (i.e. "johndoe" if the host is owned by "johndoe@example.com" Google account).  The remote access host will not start if the name of the host owner is different from the name of the local user that the host is associated with.  RemoteAccessHostMatchUsername policy should be used together with RemoteAccessHostDomain to also enforce that the Google account of the host owner is associated with a specific domain (i.e. "example.com").
+          'desc': '''If this setting is enabled, then the remote access host compares the name of the local user (that the host is associated with) and the name of the Google account registered as the host owner (i.e. "johndoe" if the host is owned by "johndoe@example.com" Google account).  The remote access host will not start if the name of the host owner is different from the name of the local user that the host is associated with.  RemoteAccessHostMatchUsername policy should be used together with RemoteAccessHostDomain to also enforce that the Google account of the host owner is associated with a specific domain (i.e. "example.com").
 
           If this setting is disabled or not set, then the remote access host can be associated with any local user.''',
         },
         {
           'name': 'RemoteAccessHostTokenUrl',
           'type': 'string',
           'schema': { 'type': 'string' },
           'supported_on': ['chrome.*:28-','chrome_os:42-'],
           'features': {
             'dynamic_refresh': True,
             'per_profile': False,
           },
           'example_value': 'https://example.com/issue',
           'id': 286,
           'caption': '''URL where remote access clients should obtain their authentication token''',
           'tags': ['website-sharing'],
-          'desc': '''URL where remote access clients should obtain their authentication token.
-
-          If this policy is set, the remote access host will require authenticating clients to obtain an authentication token from this URL in order to connect. Must be used in conjunction with RemoteAccessHostTokenValidationUrl.
+          'desc': '''If this policy is set, the remote access host will require authenticating clients to obtain an authentication token from this URL in order to connect. Must be used in conjunction with RemoteAccessHostTokenValidationUrl.
 
           This feature is currently disabled server-side.''',
         },
         {
           'name': 'RemoteAccessHostTokenValidationUrl',
           'type': 'string',
           'schema': { 'type': 'string' },
           'supported_on': ['chrome.*:28-','chrome_os:42-'],
           'features': {
             'dynamic_refresh': True,
             'per_profile': False,
           },
           'example_value': 'https://example.com/validate',
           'id': 287,
           'caption': '''URL for validating remote access client authentication token''',
           'tags': ['website-sharing'],
-          'desc': '''URL for validating remote access client authentication token.
-
-          If this policy is set, the remote access host will use this URL to validate authentication tokens from remote access clients, in order to accept connections. Must be used in conjunction with RemoteAccessHostTokenUrl.
+          'desc': '''If this policy is set, the remote access host will use this URL to validate authentication tokens from remote access clients, in order to accept connections. Must be used in conjunction with RemoteAccessHostTokenUrl.
 
           This feature is currently disabled server-side.''',
         },
         {
           'name': 'RemoteAccessHostTokenValidationCertificateIssuer',
           'type': 'string',
           'schema': { 'type': 'string' },
           'supported_on': ['chrome.*:28-','chrome_os:42-'],
           'features': {
             'dynamic_refresh': True,
             'per_profile': False,
           },
           'example_value': 'Example Certificate Authority',
           'id': 288,
           'caption': '''Client certificate for connecting to RemoteAccessHostTokenValidationUrl''',
           'tags': [],
-          'desc': '''Client certificate for connecting to RemoteAccessHostTokenValidationUrl.
-
-          If this policy is set, the host will use a client certificate with the given issuer CN to authenticate to RemoteAccessHostTokenValidationUrl. Set it to "*" to use any available client certificate.
+          'desc': '''If this policy is set, the host will use a client certificate with the given issuer CN to authenticate to RemoteAccessHostTokenValidationUrl. Set it to "*" to use any available client certificate.
 
           This feature is currently disabled server-side.''',
         },
         {
           'name': 'RemoteAccessHostDebugOverridePolicies',
           'type': 'string',
           'schema': { 'type': 'string' },
           'supported_on': ['chrome.*:25-47','chrome_os:42-47'],
           'features': {
             'dynamic_refresh': True,
@@ skipping 245 matching lines @@
           ],
           'features': {
             'can_be_recommended': True,
             'dynamic_refresh': True,
             'per_profile': True,
           },
           'example_value': True,
           'id': 16,
           'caption': '''Enable saving passwords to the password manager''',
           'tags': [],
-          'desc': '''
-          If this setting is enabled, users can have <ph
+          'desc': '''If this setting is enabled, users can have <ph
           name="PRODUCT_NAME">$1<ex>Google Chrome</ex></ph> memorize passwords
           and provide them automatically the next time they log in to a site.
 
           If this settings is disabled, users cannot save new passwords but they
           may still use passwords that have been saved previously.
 
           If this policy is enabled or disabled, users cannot change or override
           it in <ph name="PRODUCT_NAME">$1<ex>Google Chrome</ex></ph>. If this
           policy is unset, password saving is allowed (but can be turned off by
           the user).''',
@@ skipping 203 matching lines @@
       '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': '''Enables the creation of roaming copies for <ph name="PRODUCT_NAME">$1<ex>Google Chrome</ex></ph> profile data.
-
-      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="ROAMINGPROFILELOCATION_POLICY_NAME">$1<ex>RoamingProfileLocation</ex></ph> policy.
+      '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="ROAMINGPROFILELOCATION_POLICY_NAME">$1<ex>RoamingProfileLocation</ex></ph> policy.
 
       Google Sync is automatically disabled when this policy is enabled.
 
       To prevent accidental data leaks it is advisable to also set the <ph name="SIGNINALLOWED_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.''',
       'label': '''Enable the creation of roaming copies for <ph name="PRODUCT_NAME">$1<ex>Google Chrome</ex></ph> profile data.''',
     },
     {
       'name': 'RoamingProfileLocation',
@@ skipping 42 matching lines @@
       'type': 'main',
       'schema': { 'type': 'boolean' },
       'supported_on': ['chrome.*:35-42'],
       'features': {
         'dynamic_refresh': False,
         'per_profile': False,
       },
       'deprecated': True,
       'example_value': False,
       'id': 265,
-      'caption': '''Enables the old web-based signin''',
+      'caption': '''Enables the old web-based signin flow''',
       'tags': [],
-      'desc': '''Enables the old web-based signin flow.
-
-      This setting was named EnableWebBasedSignin prior to Chrome 42, and support for it will be removed entirely in Chrome 43.
+      'desc': '''This setting was named EnableWebBasedSignin prior to Chrome 42, and support for it will be removed entirely in Chrome 43.
 
       This setting is useful for enterprise customers who are using SSO solutions that are not compatible with the new inline signin flow yet.
       If you enable this setting, the old web-based signin flow would be used.
       If you disable this setting or leave it not set, the new inline signin flow would be used by default. Users may still enable the old web-based signin flow through the command line flag --enable-web-based-signin.
 
       The experimental setting will be removed in the future when the inline signin fully supports all SSO signin flows.''',
     },
     {
       'name': 'UserDataDir',
       'type': 'string',
@@ skipping 643 matching lines @@
           },
           'supported_on': ['chrome.*:9-', 'chrome_os:11-'],
           'features': {
             'dynamic_refresh': True,
             'per_profile': True,
           },
           'example_value': ['gbchcmhmhahfdphkhkmpfmihenigjmpp;https://clients2.google.com/service/update2/crx'],
           'id': 34,
           'caption': '''Configure the list of force-installed apps and extensions''',
           'tags': ['full-admin-access'],
-          'desc': '''
-          Specifies a list of apps and extensions that are installed silently,
+          'desc': '''Specifies a list of apps and extensions that are installed silently,
           without user interaction, and which cannot be uninstalled by the
           user. All permissions requested by the apps/extensions are granted
           implicitly, without user interaction, including any additional
           permissions requested by future versions of the app/extension.
           Furthermore, permissions are granted for the
           enterprise.deviceAttributes and enterprise.platformKeys extension
           APIs. (These two APIs are not available to apps/extensions that are
           not force-installed.)
 
           This policy takes precedence over a potentially conflicting
@@ skipping 383 matching lines @@
       'supported_on': ['chrome.*:10-', 'chrome_os:11-'],
       'features': {
         'can_be_recommended': True,
         'dynamic_refresh': True,
         'per_profile': True,
       },
       'example_value': False,
       'id': 39,
       'caption': '''Block third party cookies''',
       'tags': [],
-      'desc': '''Blocks third party cookies.
-
-      Enabling this setting prevents cookies from being set by web page elements that are not from the domain that is in the browser's address bar.
+      'desc': '''Enabling this setting prevents cookies from being set by web page elements that are not from the domain that is in the browser's address bar.
 
       Disabling this setting allows cookies to be set by web page elements that are not from the domain that is in the browser's address bar and prevents users from changing this setting.
 
       If this policy is left not set, third party cookies will be enabled but the user will be able to change that.''',
     },
     {
       # TODO(joaodasilva): Flag these policies with 'can_be_recommended'
       # after fixing https://crbug.com/106683
       'name': 'DefaultSearchProvider',
       'type': 'group',
@@ skipping 1190 matching lines @@
       'schema': { 'type': 'boolean' },
       'supported_on': ['chrome.*:9-', 'chrome_os:11-'],
       'features': {
         'dynamic_refresh': True,
         'per_profile': True,
       },
       'example_value': False,
       'id': 55,
       'caption': '''Disable support for 3D graphics APIs''',
       'tags': [],
-      'desc': '''Disable support for 3D graphics APIs.
-
-      Enabling this setting prevents web pages from accessing the graphics processing unit (GPU). Specifically, web pages can not access the WebGL API and plugins can not use the Pepper 3D API.
+      'desc': '''Enabling this setting prevents web pages from accessing the graphics processing unit (GPU). Specifically, web pages can not access the WebGL API and plugins can not use the Pepper 3D API.
 
       Disabling this setting or leaving it not set potentially allows web pages to use the WebGL API and plugins to use the Pepper 3D API. The default settings of the browser may still require command line arguments to be passed in order to use these APIs.
 
       If HardwareAccelerationModeEnabled is set to false, Disable3DAPIs is ignored and it is equivalent to Disable3DAPIs being set to true.''',
     },
     {
       'name': 'PolicyRefreshRate',
       'type': 'int',
       'schema': { 'type': 'integer' },
       'supported_on': ['chrome_os:11-'],
@@ skipping 165 matching lines @@
             'items': { 'type': 'string' },
           },
           'supported_on': ['chrome_frame:8-32'],
           'features': {
             'dynamic_refresh': False,
           },
           'example_value': ['text/xml', 'application/xml'],
           'id': 60,
           'caption': '''Allow <ph name="PRODUCT_FRAME_NAME">$3<ex>Google Chrome Frame</ex></ph> to handle the listed content types''',
           'tags': [],
-          'desc': '''Allow <ph name="PRODUCT_FRAME_NAME">$3<ex>Google Chrome Frame</ex></ph> to handle the listed content types.

[emaxx, 2017/04/19 13:56:27]

nit: Maybe better to keep this line for this policy, because otherwise there's
no description left for the "policy is set" case. Maybe rephrase this line a
little bit, so that it's not the same as title (but I'm also fine with keeping
the original line, as this policy has already been deprecated).

[Thiemo Nagel, 2017/04/19 15:31:11]

Thanks, rephrased.

-
-          If this policy is not set the default renderer will be used for all sites as specified by the 'ChromeFrameRendererSettings' policy.''',
+          'desc': '''If this policy is not set the default renderer will be used for all sites as specified by the 'ChromeFrameRendererSettings' policy.''',
         },
       ],
     },
     {
       'name': 'ChromeOsLockOnIdleSuspend',
       'type': 'main',
       'schema': { 'type': 'boolean' },
       'supported_on': ['chrome_os:9-'],
       'features': {
         'can_be_recommended': True,
@@ skipping 129 matching lines @@
       'schema': { 'type': 'boolean' },
       'supported_on': ['chrome.*:12-', 'chrome_os:12-'],
       'features': {
         'dynamic_refresh': True,
         'per_profile': True,
       },
       'example_value': True,
       'id': 81,
       'caption': '''Allow running plugins that are outdated''',
       'tags': ['system-security'],
-      'desc': '''Allows <ph name="PRODUCT_NAME">$1<ex>Google Chrome</ex></ph> to run plugins that are outdated.
-
-      If you enable this setting, outdated plugins are used as normal plugins.
+      'desc': '''If you enable this setting, outdated plugins are used as normal plugins.
 
       If you disable this setting, outdated plugins will not be used and users will not be asked for permission to run them.
 
       If this setting is not set, users will be asked for permission to run outdated plugins.''',
     },
     {
       'name': 'AlwaysAuthorizePlugins',
       'type': 'main',
       'schema': { 'type': 'boolean' },
       'supported_on': ['chrome.*:13-', 'chrome_os:13-'],
       'features': {
         'dynamic_refresh': True,
         'per_profile': True,
       },
       'example_value': True,
       'id': 86,
       'caption': '''Always runs plugins that require authorization''',
       'tags': ['system-security'],
-      'desc': '''Allows <ph name="PRODUCT_NAME">$1<ex>Google Chrome</ex></ph> to run plugins that require authorization.
-
-      If you enable this setting, plugins that are not outdated always run.
+      'desc': '''If you enable this setting, plugins that are not outdated always run.
 
       If this setting is disabled or not set, users will be asked for permission to run plugins that require authorization. These are plugins that can compromise security.''',
     },
     {
       'name': 'BookmarkBarEnabled',
       'type': 'main',
       'schema': { 'type': 'boolean' },
       'supported_on': ['chrome.*:12-', 'chrome_os:12-'],
       'features': {
         'can_be_recommended': True,
         'dynamic_refresh': True,
         'per_profile': True,
       },
       'example_value': True,
       'id': 82,
       'caption': '''Enable Bookmark Bar''',
       'tags': [],
-      'desc': '''Enables the bookmark bar on <ph name="PRODUCT_NAME">$1<ex>Google Chrome</ex></ph>.
-
-      If you enable this setting, <ph name="PRODUCT_NAME">$1<ex>Google Chrome</ex></ph> will show a bookmark bar.
+      'desc': '''If you enable this setting, <ph name="PRODUCT_NAME">$1<ex>Google Chrome</ex></ph> will show a bookmark bar.
 
       If you disable this setting, users will never see the bookmark bar.
 
       If you enable or disable this setting, users cannot change or override it in <ph name="PRODUCT_NAME">$1<ex>Google Chrome</ex></ph>.
 
       If this setting is left not set the user can decide to use this function or not.''',
     },
     {
       'name': 'EditBookmarksEnabled',
       'type': 'main',
       'schema': { 'type': 'boolean' },
       'supported_on': ['chrome.*:12-', 'chrome_os:12-', 'android:30-'],
       'features': {
         'dynamic_refresh': True,
         'per_profile': True,
       },
       'example_value': False,
       'id': 83,
       'caption': '''Enables or disables bookmark editing''',
       'tags': [],
-      'desc': '''Enables or disables editing bookmarks in <ph name="PRODUCT_NAME">$1<ex>Google Chrome</ex></ph>.
-
-      If you enable this setting, bookmarks can be added, removed or modified. This is the default also when this policy is not set.
+      'desc': '''If you enable this setting, bookmarks can be added, removed or modified. This is the default also when this policy is not set.
 
       If you disable this setting, bookmarks can not be added, removed or modified. Existing bookmarks are still available.''',
     },
     {
       'name': 'ShowAppsShortcutInBookmarkBar',
       'type': 'main',
       'schema': { 'type': 'boolean' },
       'supported_on': ['chrome.*:37-'],
       'features': {
         'dynamic_refresh': True,
@@ skipping 252 matching lines @@
         'ios:34-47',
       ],
       'features': {
         'dynamic_refresh': True,
         'per_profile': True,
       },
       'example_value': ['example.com', 'https://ssl.server.com', 'hosting.com/bad_path', 'https://server:8080/path', '.exact.hostname.com', 'file://*', 'custom_scheme:*', '*'],
       'id': 103,
       'caption': '''Block access to a list of URLs''',
       'tags': ['filtering'],
-      'desc': '''Blocks access to the listed URLs.
-
-      This policy prevents the user from loading web pages from blacklisted URLs. The blacklist provides a list of URL patterns that specify which URLs will be blacklisted.
+      'desc': '''This policy prevents the user from loading web pages from blacklisted URLs. The blacklist provides a list of URL patterns that specify which URLs will be blacklisted.
 
       A URL pattern has to be formatted according to https://www.chromium.org/administrators/url-blacklist-filter-format.
 
       Exceptions can be defined in the URL whitelist policy. These policies are limited to 1000 entries; subsequent entries will be ignored.
 
       Note that it is not recommended to block internal 'chrome://*' URLs since this may lead to unexpected errors.
 
       If this policy is not set no URL will be blacklisted in the browser.''',
       'arc_support': 'Android apps may voluntarily choose to honor this list. You cannot force them to honor it.',
     },
@@ skipping 341 matching lines @@
       'schema': { 'type': 'integer', 'minimum': -1 },
       'supported_on': ['chrome_os:34-'],
       'features': {
         'dynamic_refresh': True,
         'per_profile': True,
       },
       'example_value': 32,
       'id': 254,
       'caption': '''Limit the time for which a user authenticated via SAML can log in offline''',
       'tags': [],
-      'desc': '''Limit the time for which a user authenticated via SAML can log in offline.
-
-      During login, <ph name="PRODUCT_OS_NAME">$2<ex>Google Chrome OS</ex></ph> can authenticate against a server (online) or using a cached password (offline).
+      'desc': '''During login, <ph name="PRODUCT_OS_NAME">$2<ex>Google Chrome OS</ex></ph> can authenticate against a server (online) or using a cached password (offline).
 
       When this policy is set to a value of -1, the user can authenticate offline indefinitely. When this policy is set to any other value, it specifies the length of time since the last online authentication after which the user must use online authentication again.
 
       Leaving this policy not set will make <ph name="PRODUCT_OS_NAME">$2<ex>Google Chrome OS</ex></ph> use a default time limit of 14 days after which the user must use online authentication again.
 
       This policy affects only users who authenticated using SAML.
 
       The policy value should be specified in seconds.''',
     },
     {
@@ skipping 1007 matching lines @@
       'schema': { 'type': 'boolean' },
       'supported_on': ['chrome_os:23-'],
       'features': {
         'dynamic_refresh': True,
         'per_profile': False,
       },
       'example_value': False,
       'id': 159,
       'caption': '''Allow playing audio''',
       'tags': [],
-      'desc': '''Allow playing audio.
-
-      When this policy is set to false, audio output will not be available on the device while the user is logged in.
+      'desc': '''When this policy is set to false, audio output will not be available on the device while the user is logged in.
 
       This policy affects all types of audio output and not only the built-in speakers. Audio accessibility features are also inhibited by this policy. Do not enable this policy if a screen reader is required for the user.
 
       If this setting is set to true or not configured then users can use all supported audio outputs on their device.''',
     },
     {
       'name': 'AudioCaptureAllowed',
       'type': 'main',
       'schema': { 'type': 'boolean' },
       'supported_on': ['chrome.*:25-', 'chrome_os:23-'],
       'features': {
         'dynamic_refresh': True,
         'per_profile': False,
       },
       'example_value': False,
       'id': 160,
       'caption': '''Allow or deny audio capture''',
       'tags': [],
-      'desc': '''Allow or deny audio capture.
-
-      If enabled or not configured (default), the user will be prompted for
+      'desc': '''If enabled or not configured (default), the user will be prompted for
       audio capture access except for URLs configured in the
       AudioCaptureAllowedUrls list which will be granted access without prompting.
 
       When this policy is disabled, the user will never be prompted and audio
       capture only be available to URLs configured in AudioCaptureAllowedUrls.
 
       This policy affects all types of audio inputs and not only the built-in microphone.''',
       'arc_support': 'For Android apps, this policy affects the microphone only. When this policy is set to true, the microphone is muted for all Android apps, with no exceptions.',
     },
     {
@@ skipping 24 matching lines @@
       'schema': { 'type': 'boolean' },
       'supported_on': ['chrome.*:25-', 'chrome_os:25-'],
       'features': {
         'dynamic_refresh': True,
         'per_profile': True,
       },
       'example_value': False,
       'id': 167,
       'caption': '''Allow or deny video capture''',
       'tags': [],
-      'desc': '''Allow or deny video capture.
-
-      If enabled or not configured (default), the user will be prompted for
+      'desc': '''If enabled or not configured (default), the user will be prompted for
       video capture access except for URLs configured in the
       VideoCaptureAllowedUrls list which will be granted access without prompting.
 
       When this policy is disabled, the user will never be prompted and video
       capture only be available to URLs configured in VideoCaptureAllowedUrls.
 
       This policy affects all types of video inputs and not only the built-in camera.''',
       'arc_support': 'For Android apps, this policy affects the built-in camera only. When this policy is set to true, the camera is disabled for all Android apps, with no exceptions.',
     },
     {
@@ skipping 24 matching lines @@
       'schema': { 'type': 'boolean' },
       'supported_on': ['chrome_os:22-', 'chrome.*:22-'],
       'features': {
         'dynamic_refresh': True,
         'per_profile': False,
       },
       'example_value': True,
       'id': 153,
       'caption': '''Disable taking screenshots''',
       'tags': [],
-      'desc': '''Disables taking screenshots.
-
-      If enabled screenshots cannot be taken using keyboard shortcuts or extension APIs.
+      'desc': '''If enabled screenshots cannot be taken using keyboard shortcuts or extension APIs.

[emaxx, 2017/04/19 13:56:27]

nit: While you're here, maybe add a comma after "enabled".

[Thiemo Nagel, 2017/04/19 15:31:11]

Done.

 
       If disabled or not specified, taking screenshots is allowed.'''
     },
     {
       'name': 'SystemTimezone',
       'type': 'string',
       'schema': { 'type': 'string' },
       'supported_on': ['chrome_os:22-'],
       'device_only': True,
       'features': {
@@ skipping 63 matching lines @@
       'schema': { 'type': 'boolean' },
       'supported_on': ['chrome_os:25-'],
       'features': {
         'dynamic_refresh': True,
         'per_profile': True,
       },
       'example_value': True,
       'id': 164,
       'caption': '''Add a logout button to the system tray''',
       'tags': [],
-      'desc': '''Adds a logout button to the system tray.
-
-      If enabled, a big, red logout button is shown in the system tray while a session is active and the screen is not locked.
+      'desc': '''If enabled, a big, red logout button is shown in the system tray while a session is active and the screen is not locked.
 
       If disabled or not specified, no big, red logout button is shown in the system tray.''',
     },
     {
       'name': 'BuiltInDnsClientEnabled',
       'type': 'main',
       'schema': { 'type': 'boolean' },
       'supported_on': ['chrome.*:25-'],
       'features': {
         'dynamic_refresh': True,
@@ skipping 78 matching lines @@
       'name': 'SessionLengthLimit',
       'type': 'int',
       'schema': { 'type': 'integer' },
       'supported_on': ['chrome_os:25-'],
       'features': {
         'dynamic_refresh': True,
         'per_profile': False,
       },
       'example_value': 3600000,
       'id': 170,
-      'caption': '''Limit the session length''',
+      'caption': '''Limit the length of a user session''',
       'tags': [],
-      'desc': '''Limit the maximum length of a user session.
-
-      When this policy is set, it specifies the length of time after which a user is automatically logged out, terminating the session. The user is informed about the remaining time by a countdown timer shown in the system tray.
+      'desc': '''When this policy is set, it specifies the length of time after which a user is automatically logged out, terminating the session. The user is informed about the remaining time by a countdown timer shown in the system tray.
 
       When this policy is not set, the session length is not limited.
 
       If you set this policy, users cannot change or override it.
 
       The policy value should be specified in milliseconds. Values are clamped to a range of 30 seconds to 24 hours.''',
     },
     {
       'name': 'FullscreenAllowed',
       'type': 'main',
       'schema': { 'type': 'boolean' },
       'supported_on': ['chrome.win:31-', 'chrome.linux:31-', 'chrome_os:31-'],
       'features': {
         'dynamic_refresh': True,
         'per_profile': True,
       },
       'example_value': True,
       'id': 240,
       'caption': '''Allow fullscreen mode''',
       'tags': [],
-      'desc': '''Allow fullscreen mode.
-
-      This policy controls the availability of fullscreen mode in which all <ph name="PRODUCT_NAME">$1<ex>Google Chrome</ex></ph> UI is hidden and only web content is visible.
+      'desc': '''This policy controls the availability of fullscreen mode in which all <ph name="PRODUCT_NAME">$1<ex>Google Chrome</ex></ph> UI is hidden and only web content is visible.
 
       If this policy is set to true or not not configured, the user, apps and extensions with appropriate permissions can enter fullscreen mode.
 
       If this policy is set to false, neither the user nor any apps or extensions can enter fullscreen mode.
 
       On all platforms except <ph name="PRODUCT_OS_NAME">$2<ex>Google Chrome OS</ex></ph>, kiosk mode is unavailable when fullscreen mode is disabled.''',
       'arc_support': 'This policy has no effect on the Android apps. They will be able to enter fullscreen mode even if this policy is set to <ph name="FALSE">False</ph>.',
     },
     {
       'name': 'PowerManagement',
@@ skipping 301 matching lines @@
           'supported_on': ['chrome_os:26-'],
           'features': {
             'dynamic_refresh': True,
             'per_profile': False,
           },
           'deprecated': True,
           'example_value': 0,
           'id': 180,
           'caption': '''Action to take when the idle delay is reached''',
           'tags': [],
-          'desc': '''Specify the action to take when the idle delay is reached.
-
-          Note that this policy is deprecated and will be removed in the future.
+          'desc': '''Note that this policy is deprecated and will be removed in the future.
 
           This policy provides a fallback value for the more-specific <ph name="IDLEACTIONAC_POLICY_NAME">IdleActionAC</ph> and <ph name="IDLEACTIONBATTERY_POLICY_NAME">IdleActionBattery</ph> policies. If this policy is set, its value gets used if the respective more-specific policy is not set.
 
           When this policy is unset, behavior of the more-specific policies remains unaffected.''',
         },
         {
           'name': 'IdleActionAC',
           'type': 'int-enum',
           'schema': {
             'type': 'integer',
@@ skipping 24 matching lines @@
           'supported_on': ['chrome_os:30-'],
           'features': {
             'dynamic_refresh': True,
             'per_profile': False,
           },
           'deprecated': True,
           'example_value': 0,
           'id': 226,
           'caption': '''Action to take when the idle delay is reached while running on AC power''',
           'tags': [],
-          'desc': '''Specify the action to take when the idle delay is reached while running on AC power.
-
-          When this policy is set, it specifies the action that <ph name="PRODUCT_OS_NAME">$2<ex>Google Chrome OS</ex></ph> takes when the user remains idle for the length of time given by the idle delay, which can be configured separately.
+          'desc': '''When this policy is set, it specifies the action that <ph name="PRODUCT_OS_NAME">$2<ex>Google Chrome OS</ex></ph> takes when the user remains idle for the length of time given by the idle delay, which can be configured separately.
 
           When this policy is unset, the default action is taken, which is suspend.
 
           If the action is suspend, <ph name="PRODUCT_OS_NAME">$2<ex>Google Chrome OS</ex></ph> can separately be configured to either lock or not lock the screen before suspending.''',
         },
         {
           'name': 'IdleActionBattery',
           'type': 'int-enum',
           'schema': {
             'type': 'integer',
@@ skipping 24 matching lines @@
           'supported_on': ['chrome_os:30-'],
           'features': {
             'dynamic_refresh': True,
             'per_profile': False,
           },
           'deprecated': True,
           'example_value': 0,
           'id': 222,
           'caption': '''Action to take when the idle delay is reached while running on battery power''',
           'tags': [],
-          'desc': '''Specify the action to take when the idle delay is reached while running on battery power.
-
-          When this policy is set, it specifies the action that <ph name="PRODUCT_OS_NAME">$2<ex>Google Chrome OS</ex></ph> takes when the user remains idle for the length of time given by the idle delay, which can be configured separately.
+          'desc': '''When this policy is set, it specifies the action that <ph name="PRODUCT_OS_NAME">$2<ex>Google Chrome OS</ex></ph> takes when the user remains idle for the length of time given by the idle delay, which can be configured separately.
 
           When this policy is unset, the default action is taken, which is suspend.
 
           If the action is suspend, <ph name="PRODUCT_OS_NAME">$2<ex>Google Chrome OS</ex></ph> can separately be configured to either lock or not lock the screen before suspending.''',
         },
         {
           'name': 'LidCloseAction',
           'type': 'int-enum',
           'schema': {
             'type': 'integer',
@@ skipping 23 matching lines @@
           ],
           'supported_on': ['chrome_os:26-'],
           'features': {
             'dynamic_refresh': True,
             'per_profile': False,
           },
           'example_value': 0,
           'id': 181,
           'caption': '''Action to take when the user closes the lid''',
           'tags': [],
-          'desc': '''Specify the action to take when the user closes the lid.
-
-          When this policy is set, it specifies the action that <ph name="PRODUCT_OS_NAME">$2<ex>Google Chrome OS</ex></ph> takes when the user closes the device's lid.
+          'desc': '''When this policy is set, it specifies the action that <ph name="PRODUCT_OS_NAME">$2<ex>Google Chrome OS</ex></ph> takes when the user closes the device's lid.
 
           When this policy is unset, the default action is taken, which is suspend.
 
           If the action is suspend, <ph name="PRODUCT_OS_NAME">$2<ex>Google Chrome OS</ex></ph> can separately be configured to either lock or not lock the screen before suspending.''',
         },
         {
           'name': 'PowerManagementUsesAudioActivity',
           'type': 'main',
           'schema': { 'type': 'boolean' },
           'supported_on': ['chrome_os:26-'],
           'features': {
             'dynamic_refresh': True,
             'per_profile': False,
           },
           'example_value': True,
           'id': 182,
           'caption': '''Specify whether audio activity affects power management''',
           'tags': [],
-          'desc': '''Specifies whether audio activity affects power management.
-
-          If this policy is set to True or is unset, the user is not considered to be idle while audio is playing. This prevents the idle timeout from being reached and the idle action from being taken. However, screen dimming, screen off and screen lock will be performed after the configured timeouts, irrespective of audio activity.
+          'desc': '''If this policy is set to True or is unset, the user is not considered to be idle while audio is playing. This prevents the idle timeout from being reached and the idle action from being taken. However, screen dimming, screen off and screen lock will be performed after the configured timeouts, irrespective of audio activity.
 
           If this policy is set to False, audio activity does not prevent the user from being considered idle.''',
         },
         {
           'name': 'PowerManagementUsesVideoActivity',
           'type': 'main',
           'schema': { 'type': 'boolean' },
           'supported_on': ['chrome_os:26-'],
           'features': {
             'dynamic_refresh': True,
             'per_profile': False,
           },
           'example_value': True,
           'id': 183,
           'caption': '''Specify whether video activity affects power management''',
           'tags': [],
-          'desc': '''Specifies whether video activity affects power management.
-
-          If this policy is set to True or is unset, the user is not considered to be idle while video is playing. This prevents the idle delay, screen dim delay, screen off delay and screen lock delay from being reached and the corresponding actions from being taken.
+          'desc': '''If this policy is set to True or is unset, the user is not considered to be idle while video is playing. This prevents the idle delay, screen dim delay, screen off delay and screen lock delay from being reached and the corresponding actions from being taken.
 
           If this policy is set to False, video activity does not prevent the user from being considered idle.''',
           'arc_support': 'Video playing in Android apps is not taken into consideration, even if this policy is set to <ph name="TRUE">True</ph>.',
         },
         {
           'name': 'PresentationIdleDelayScale',
           'type': 'int',
           'schema': { 'type': 'integer' },
           'supported_on': ['chrome_os:26-28'],
           'features': {
@@ skipping 145 matching lines @@
             'AC': {
               'IdleAction': 'DoNothing'
             },
             'Battery': {
               'IdleAction': 'DoNothing'
             }
           },
           'id': 258,
           'caption': '''Power management settings when the user becomes idle''',
           'tags': [],
-          'desc': '''Configure power management settings when the user becomes idle.
-
-          This policy controls multiple settings for the power management strategy when the user becomes idle.
+          'desc': '''This policy controls multiple settings for the power management strategy when the user becomes idle.
 
           There are four types of action:
           * The screen will be dimmed if the user remains idle for the time specified by |ScreenDim|.
           * The screen will be turned off if the user remains idle for the time specified by |ScreenOff|.
           * A warning dialog will be shown if the user remains idle for the time specified by |IdleWarning|, telling the user that the idle action is about to be taken.
           * The action specified by |IdleAction| will be taken if the user remains idle for the time specified by |Idle|.
 
           For each of above actions, the delay should be specified in milliseconds, and needs to be set to a value greater than zero to trigger the corresponding action. In case the delay is set to zero, <ph name="PRODUCT_OS_NAME">$2<ex>Google Chrome OS</ex></ph> will not take the corresponding action.
 
           For each of the above delays, when the length of time is unset, a default value will be used.
@@ skipping 188 matching lines @@
           'supported_on': ['chrome_os:27-'],
           'features': {
             'can_be_recommended': True,
             'dynamic_refresh': True,
             'per_profile': True,
           },
           'example_value': True,
           'id': 188,
           'caption': '''Show accessibility options in system tray menu''',
           'tags': [],
-          'desc': '''Show <ph name="PRODUCT_OS_NAME">$2<ex>Google Chrome OS</ex></ph> accessibility options in the system menu.
-
-          If this policy is set to true, Accessibility options always appear in system tray menu.
+          'desc': '''If this policy is set to true, Accessibility options always appear in system tray menu.
 
           If this policy is set to false, Accessibility options never appear in system tray menu.
 
           If you set this policy, users cannot change or override it.
 
           If this policy is left unset, Accessibility options will not appear in the system tray menu, but the user can cause the Accessibility options to appear via the Settings page.'''
         },
         {
           'name': 'LargeCursorEnabled',
           'type': 'main',
@@ skipping 132 matching lines @@
           'supported_on': ['chrome_os:29-'],
           'features': {
             'can_be_recommended': True,
             'dynamic_refresh': True,
             'per_profile': True,
           },
           'example_value': 1,
           'id': 214,
           'caption': '''Set screen magnifier type''',
           'tags': [],
-          'desc': '''Set the type of screen magnifier that is enabled.
-
-          If this policy is set, it controls the type of screen magnifier that is enabled. Setting the policy to "None" disables the screen magnifier.
+          'desc': '''If this policy is set, it controls the type of screen magnifier that is enabled. Setting the policy to "None" disables the screen magnifier.
 
           If you set this policy, users cannot change or override it.
 
           If this policy is left unset, the screen magnifier is disabled initially but can be enabled by the user anytime.''',
         },
         {
           'name': 'DeviceLoginScreenDefaultLargeCursorEnabled',
           'type': 'main',
           'schema': { 'type': 'boolean' },
           'supported_on': ['chrome_os:29-'],
@@ skipping 378 matching lines @@
           ],
           'supported_on': ['chrome.*:28-', 'chrome_os:28-'],
           'features': {
             'dynamic_refresh': True,
             'per_profile': True
           },
           'example_value': 2,
           'id': 204,
           'caption': '''Default behavior for sites not in any content pack''',
           'tags': [],
-          'desc': '''The default behavior for sites not in any content pack.

[emaxx, 2017/04/19 13:56:27]

nit: Maybe keep some descriptive line of text here too?

[Thiemo Nagel, 2017/04/19 15:31:11]

Imho the duplicate line adds no value.  As it's for internal use only, I'd
prefer not to spend effort on it.

-
-          This policy is for internal use by <ph name="PRODUCT_NAME">$1<ex>Google Chrome</ex></ph> itself.''',
+          'desc': '''This policy is for internal use by <ph name="PRODUCT_NAME">$1<ex>Google Chrome</ex></ph> itself.''',
         },
         {
           'name': 'ContentPackManualBehaviorHosts',
           'future': True,
           'deprecated': True,
           'type': 'dict',
           'schema': {
             'type': 'object',
             'additionalProperties': {
               'type': 'boolean'
@@ skipping 206 matching lines @@
       'supported_on': ['chrome_os:34-'],
       'features': {
         'dynamic_refresh': True,
         'per_profile': True,
       },
       'example_value': { "url": "https://example.com/avatar.jpg", "hash": "deadbeefdeadbeefdeadbeefdeadbeefdeadbeefdeadbeefdeadbeefdeadbeef" },
       'max_size': 524288,
       'id': 249,
       'caption': '''User avatar image''',
       'tags': [],
-      'desc': '''Configure user avatar image.
-
-      This policy allows you to configure the avatar image representing the user on the login screen. The policy is set by specifying the URL from which <ph name="PRODUCT_OS_NAME">$2<ex>Google Chrome OS</ex></ph> can download the avatar image and a cryptographic hash used to verify the integrity of the download. The image must be in JPEG format, its size must not exceed 512kB. The URL must be accessible without any authentication.
+      'desc': '''This policy allows you to configure the avatar image representing the user on the login screen. The policy is set by specifying the URL from which <ph name="PRODUCT_OS_NAME">$2<ex>Google Chrome OS</ex></ph> can download the avatar image and a cryptographic hash used to verify the integrity of the download. The image must be in JPEG format, its size must not exceed 512kB. The URL must be accessible without any authentication.
 
       The avatar image is downloaded and cached. It will be re-downloaded whenever the URL or the hash changes.
 
       The policy should be specified as a string that expresses the URL and hash in JSON format, conforming to the following schema:
       {
         "type": "object",
         "properties": {
           "url": {
             "description": "The URL from which the avatar image can be downloaded.",
             "type": "string"
@@ skipping 24 matching lines @@
       'supported_on': ['chrome_os:35-'],
       'features': {
         'dynamic_refresh': True,
         'per_profile': True,
       },
       'example_value': { "url": "https://example.com/wallpaper.jpg", "hash": "baddecafbaddecafbaddecafbaddecafbaddecafbaddecafbaddecafbaddecaf" },
       'max_size': 16777216,
       'id': 262,
       'caption': '''Wallpaper image''',
       'tags': [],
-      'desc': '''Configure wallpaper image.
-
-      This policy allows you to configure the wallpaper image that is shown on the desktop and on the login screen background for the user. The policy is set by specifying the URL from which <ph name="PRODUCT_OS_NAME">$2<ex>Google Chrome OS</ex></ph> can download the wallpaper image and a cryptographic hash used to verify the integrity of the download. The image must be in JPEG format, its file size must not exceed 16MB. The URL must be accessible without any authentication.
+      'desc': '''This policy allows you to configure the wallpaper image that is shown on the desktop and on the login screen background for the user. The policy is set by specifying the URL from which <ph name="PRODUCT_OS_NAME">$2<ex>Google Chrome OS</ex></ph> can download the wallpaper image and a cryptographic hash used to verify the integrity of the download. The image must be in JPEG format, its file size must not exceed 16MB. The URL must be accessible without any authentication.
 
       The wallpaper image is downloaded and cached. It will be re-downloaded whenever the URL or the hash changes.
 
       The policy should be specified as a string that expresses the URL and hash in JSON format, conforming to the following schema:
       {
         "type": "object",
         "properties": {
           "url": {
             "description": "The URL from which the wallpaper image can be downloaded.",
             "type": "string"
@@ skipping 79 matching lines @@
       'supported_on': ['chrome_os:38-'],
       'features': {
         'dynamic_refresh': True,
         'per_profile': True,
       },
       'example_value': True,
       'default_for_enterprise_users': False,
       'id': 272,
       'caption': '''Allows Smart Lock to be used''',
       'tags': [],
-      'desc': '''Allows Smart Lock to be used on <ph name="PRODUCT_OS_NAME">$2<ex>Google Chrome OS</ex></ph> devices.
-
-      If you enable this setting, users will be allowed to use Smart Lock if the requirements for the feature are satisfied.
+      'desc': '''If you enable this setting, users will be allowed to use Smart Lock if the requirements for the feature are satisfied.
 
       If you disable this setting, users will not be allowed to use Smart Lock.
 
       If this policy is left not set, the default is not allowed for enterprise-managed users and allowed for non-managed users.''',
     },
     {
       'name': 'SessionLocales',
       'type': 'list',
       'schema': {
         'type': 'array',
@@ skipping 465 matching lines @@
       'arc_support': 'Android apps cannot get access to corporate keys. This policy has no effect on them.',
     },
     {
       'name': 'WelcomePageOnOSUpgradeEnabled',
       'supported_on': ['chrome.win:45-'],
       'type': 'main',
       'schema': { 'type': 'boolean' },
       'id': 303,
       'caption': 'Enable showing the welcome page on the first browser launch following OS upgrade.',
       'tags': [],
-      'desc': '''Enable showing the welcome page on the first browser launch following OS upgrade.
-
-      If this policy is set to true or not configured, the browser will re-show the welcome page on the first launch following an OS upgrade.
+      'desc': '''If this policy is set to true or not configured, the browser will re-show the welcome page on the first launch following an OS upgrade.
 
       If this policy is set to false, the browser will not re-show the welcome page on the first launch following an OS upgrade.''',
       'features': {
         'dynamic_refresh': False,
         'per_profile': False
       },
       'example_value': False
     },
     {
       'name': 'HardwareAccelerationModeEnabled',
       'type': 'main',
       'schema': { 'type': 'boolean' },
       'supported_on': ['chrome.*:46-'],
       'features': {
         'dynamic_refresh': False,
         'per_profile': False,
       },
       'example_value': True,
       'id': 304,
       'caption': '''Use hardware acceleration when available''',
       'tags': [],
-      'desc': '''Use hardware acceleration when available.
-
-      If this policy is set to true or left unset, hardware acceleration will be enabled unless a certain GPU feature is blacklisted.
+      'desc': '''If this policy is set to true or left unset, hardware acceleration will be enabled unless a certain GPU feature is blacklisted.
 
       If this policy is set to false, hardware acceleration will be disabled.''',
     },
     {
       'name': 'UnifiedDesktopEnabledByDefault',
       'type': 'main',
       'schema': { 'type': 'boolean' },
       'supported_on': ['chrome_os:47-'],
       'features': {
         'can_be_recommended': False,
@@ skipping 314 matching lines @@
 
       If set to TimezoneAutomaticDetectionSendAllLocationInfo, timezone controls in chrome://settings will be disabled. Automatic timezone detection will be always on. Location information (such as WiFi access-points, reachable Cell Towers, GPS) will be sent to a server for fine-grained timezone detection.
 
       If this policy is not set, it will behave as if TimezoneAutomaticDetectionUsersDecide is set.
 
       If SystemTimezone policy is set, it overrides this policy. In this case automatic timezone detection is completely disabled.''',
     },
     {
       'name': 'TaskManagerEndProcessEnabled',
       'caption': '''Enables ending processes in Task Manager''',
-      'desc': '''Enables ending processes in <ph name="PRODUCT_NAME">$1<ex>Google Chrome</ex></ph>'s Task Manager.
-
-      If set to false, the 'End process' button is disabled in the Task Manager.
+      'desc': '''If set to false, the 'End process' button is disabled in the Task Manager.
 
       If set to true or not configured, the user can end processes in the Task Manager.''',
       'type': 'main',
       'schema': { 'type': 'boolean' },
       'supported_on': ['chrome.*:52-','chrome_os:52-'],
       'features': {
         'dynamic_refresh': True,
         'per_profile': False,
       },
       'example_value': True,
@@ skipping 103 matching lines @@
       For example, <ph
       name="EXTENSION_POLICY_EXAMPLE">gbchcmhmhahfdphkhkmpfmihenigjmpp;https://clients2.google.com/service/update2/crx</ph>
       installs the <ph name="EXTENSION_POLICY_EXAMPLE_EXTENSION_NAME">Chrome
       Remote Desktop</ph> app from the standard Chrome Web Store "update"
       URL. For more information about hosting extensions, see: <ph
       name="LINK_TO_EXTENSION_DOC2">https://developer.chrome.com/extensions/hosting</ph>.''',
     },
     {
       'name': 'AllowScreenLock',
       'caption': '''Permit locking the screen''',
-      'desc': '''Permit locking the screen.
-
-      If this policy is set to false, users will not be able to lock the screen (only signing out from the user session will be possible). If this setting is set to true or not set, users who authenticated with a password can lock the screen.''',
+      'desc': '''If this policy is set to false, users will not be able to lock the screen (only signing out from the user session will be possible). If this setting is set to true or not set, users who authenticated with a password can lock the screen.''',
       'type': 'main',
       'schema': { 'type': 'boolean' },
       'supported_on': ['chrome_os:52-'],
       'features': {
         'dynamic_refresh': True,
         'per_profile': True,
       },
       'example_value': False,
       'tags': [],
       'id': 329,
@@ skipping 425 matching lines @@
           'schema': { 'type': 'integer' },
           'supported_on': ['chrome_os:57-'],
           'features': {
             'dynamic_refresh': True,
             'per_profile': True,
           },
           'example_value': 6,
           'id': 354,
           'caption': '''Sets the minimum length of the lock screen PIN.''',
           'tags': [],
-          'desc': '''This setting controls the minimum PIN length.

[emaxx, 2017/04/19 13:56:27]

nit: Maybe keep some descriptive line of text here too?

[Thiemo Nagel, 2017/04/19 15:31:11]

Done.

-
-          The absolute minimum PIN length is 1; values less than 1 are treated as 1.
+          'desc': '''The absolute minimum PIN length is 1; values less than 1 are treated as 1.
 
           The default and recommended minimum PIN length is 6 digits.''',
         },
         {
           'name': 'PinUnlockMaximumLength',
           'type': 'int',
           'schema': { 'type': 'integer' },
           'supported_on': ['chrome_os:57-'],
           'features': {
             'dynamic_refresh': True,
             'per_profile': True,
           },
           'example_value': 0,
           'id': 355,
           'caption': '''Sets the maximum length of the lock screen PIN.''',
           'tags': [],
-          'desc': '''This setting controls the maximum PIN length.

[emaxx, 2017/04/19 13:56:27]

nit: Maybe keep some descriptive line of text here too?

[Thiemo Nagel, 2017/04/19 15:31:11]

Done.

-
-          If this setting is 0 or less, there is no maximum length; the user can set a PIN as long as they want.
+          'desc': '''If this setting is 0 or less, there is no maximum length; the user can set a PIN as long as they want.
 
           If this setting is less than PinUnlockMinimumLength but greater than 0, the maximum length is the same as the minimum length.
 
           This setting defaults to no maximum length.''',
         },
         {
           'name': 'PinUnlockWeakPinsAllowed',
           'type': 'main',
           'schema': { 'type': 'boolean' },
           'supported_on': ['chrome_os:57-'],
@@ skipping 213 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': [],
 }