Documented how to add bookmark folders with the ManagedBookmarks policy.

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 6400 matching lines @@
           "name": "Youtube",
           "url": "youtube.com"
         }
       ],
       'id': 227,
       'caption': '''Managed Bookmarks''',
       'desc': '''Configures a list of managed bookmarks.
 
       The policy is a list of bookmarks, and each bookmark is a dictionary containing the bookmark "name" and target "url".
 
+      A bookmark can also be configured as a folder. In that case, define the folder "name" but don't define an "url"; instead, define the folder contents as another list of bookmarks under the "children" key.

[bartfab (slow), 2014/08/28 13:21:17]

Nit: Is it possible to specify in JSON schema somehow that there can only be
either |url| or |children|?

[Joao da Silva, 2014/08/28 13:38:09]

It is but it's complicated :-)

Basically, the "type" field can map to a specific type (that's what we're using
all over the place) but it can also map to a list of types. In that case, the
value must match one of those types. This simple example would allow a string or
a boolean:

  "type": [ "string", "boolean" ]

Interestingly, instead of naming a type you can just inline another schema.

So the "type: object" line above could be broken into "type: [ { schema_for_urls
}, { schema_for_folders } ]"

Unfortunately the schema validator doesn't support this yet :-) It's nice that
JSON schema can express union types like this, but I'm not sure we will
implement it without a good reason for it.

+
       These bookmarks are placed in a Managed bookmarks folder inside the Mobile bookmarks. These bookmarks can't be modified by the user.
 
       When this policy is set then the Managed bookmarks are the default folder opened when the bookmarks view is opened in <ph name="PRODUCT_NAME">$1<ex>Google Chrome</ex></ph>.
 
       Managed bookmarks are not synced to the user account.''',
     },
     {
       'name': 'DataCompressionProxyEnabled',
       'type': 'main',
       'schema': { 'type': 'boolean' },
@@ skipping 340 matching lines @@
       'desc': '''Text appended in parentheses to the policy name to indicate that it has been deprecated''',
       'text': 'deprecated',
     },
     'doc_recommended': {
       '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)',
     },
   },
   'placeholders': [],
 }