Use the externally_connectable schema from manifest_types.json to generate its

chrome/common/extensions/api/manifest_types.json

Index: chrome/common/extensions/api/manifest_types.json
diff --git a/chrome/common/extensions/api/manifest_types.json b/chrome/common/extensions/api/manifest_types.json
index d7e8494b46f6e398f9b8c3274099cc614b1686c7..f62d4f7c3c684d9ab31e96339f03b27789efb0ea 100644
--- a/chrome/common/extensions/api/manifest_types.json
+++ b/chrome/common/extensions/api/manifest_types.json
@@ -3,7 +3,6 @@
 // found in the LICENSE file.
 
 // The type schemas for structured manifest items. Not actually a callable API.
-// TODO(kalman): Expose these in the docs somewhere.
 
 [
   {
@@ -13,16 +12,18 @@
       {
         "id": "ExternallyConnectable",
         "type": "object",
-        "description": "The schema of the <code>externally_connectable</code> manifest property",
+        // Note: description commented out because externally_connectable.html
+        // already describes it, and the repetition looks odd.
+        // "description": "The <code>externally_connectable</code> manifest property declares which extensions, apps, and web pages can connect to your extension via $ref:runtime.connect and $ref:runtime.sendMessage.",
         "properties": {
-          "matches": {
-            "description": "<p>The URL patterns for web pages that are allowed to connect. If left empty or unspecified, no web pages can connect.</p><p>Patterns cannot include wildcard domains nor subdomains of (effective) top level domains; <code>*://google.com/*</code> and <code>http://*.chromium.org/*</code> are valid, while <code>&lt;all_urls&gt;</code>, <code>http://*/*</code>, <code>*://*.com/*</code>, and even <code>http://*.appspot.com/*</code> are not.</p>",
+          "ids": {
+            "description": "<p>The IDs of extensions or apps that are allowed to connect. If left empty or unspecified, no extensions nor apps can connect.</p><p>The wildcard <code>\"*\"</code> will allow all extensions and apps to connect.</p>",

[miket_OOO, 2013/08/21 19:32:37]

nor => or

[not at google - send to devlin, 2013/08/21 22:44:29]

Done.

             "optional": true,
             "type": "array",
             "items": {"type": "string"}
           },
-          "ids": {
-            "description": "The IDs of extensions or apps that are allowed to connect. If left empty or unspecified, no extensions nor apps can connect. <code>*</code> will match all extension and app IDs.",
+          "matches": {
+            "description": "<p>The URL patterns for <em>web pages</em> that are allowed to connect. <em>This does not affect content scripts.</em> If left empty or unspecified, no web pages can connect.</p><p>Patterns cannot include wildcard domains nor subdomains of (effective) top level domains; <code>*://google.com/*</code> and <code>http://*.chromium.org/*</code> are valid, while <code>&lt;all_urls&gt;</code>, <code>http://*/*</code>, <code>*://*.com/*</code>, and even <code>http://*.appspot.com/*</code> are not.</p>",
             "optional": true,
             "type": "array",
             "items": {"type": "string"}