Dynamically generate a heading for Extension Docs API pages

chrome/common/extensions/docs/templates/json/intro_tables.json

Index: chrome/common/extensions/docs/templates/json/intro_tables.json
diff --git a/chrome/common/extensions/docs/templates/json/intro_tables.json b/chrome/common/extensions/docs/templates/json/intro_tables.json
new file mode 100644
index 0000000000000000000000000000000000000000..6653245bb4c10b2cf3e64b5844265c28937d4a68
--- /dev/null
+++ b/chrome/common/extensions/docs/templates/json/intro_tables.json
@@ -0,0 +1,144 @@
+{
+  "alarms": [
+    { "Permissions": "<code>\"alarms\"</code>" },

[not at google - send to devlin, 2013/04/30 18:34:19]

Permissions are always in <code>"..."</code>, and when they get replaced with
figuring out from _permission_features.json that will probably need to be
incorporated into the templates. So let's just make these the name of the
permissions.

(generally speaking, the less HTML specific layout in these files, the better)

[epeterson, 2013/05/13 02:38:10]

Done.

+    { "Learn more": "<a href='event_pages.html'>Event Pages</a>" }
+  ],
+  "app_runtime": [
+    { "Permissions": "None" },

[not at google - send to devlin, 2013/04/30 18:34:19]

Likewise, leave out permissions if there aren't any.

[epeterson, 2013/05/13 02:38:10]

Done.

+    { "Learn more": "<a href='app_lifecycle.html'>Manage App Lifecycle</a><br><a href='https://developers.google.com/live/shows/10291095/'>Chrome Office Hours: Introduction to Chrome Apps</a>" }

[not at google - send to devlin, 2013/04/30 18:34:19]

Maybe "Learn more" should be a list in the JSON.

[epeterson, 2013/05/13 02:38:10]

Done.

+  ],
+  "app_window": [
+    { "Permissions": "None" },
+    { "Learn more": "<a href='about_apps.html#look'>How they look</a><br><a href='app_lifecycle.html'>Manage App Lifecycle</a><br><a href='https://developers.google.com/live/shows/9118010/'>Chrome Apps Office Hours: Building Awesome Multi-window Apps</a>" }
+  ],
+  "bluetooth": [
+    { "Permissions": "<code>\"bluetooth\"</code>" },
+    { "Learn more": "<a href='app_hardware.html'>Accessing Hardware Devices</a>" }
+  ],
+  "bookmarks": [
+    { "Permissions": "<code>\"bookmarks\"</code>" }
+  ],
+  "browsingData": [
+    { "Permissions": "<code>\"browsingData\"</code>" }
+  ],
+  "commands": [
+    { "Permissions": "None" }
+  ],
+  "contentSettings": [
+    { "Permissions": "<code>\"contentSettings\"</code>" }
+  ],
+  "contextMenus": [
+    { "Permissions": "<code>\"contextMenus\"</code>" }
+  ],
+  "cookies": [
+    { "Permissions": "<code>\"cookies\"</code><br><a href=\"declare_permissions.html\">host permissions</a>" }

[not at google - send to devlin, 2013/04/30 18:34:19]

Looking through this file more carefully, I'm thinking that 'Permissions'
actually needs to be a bit richer unfortunately, since there is a lot of extra
data in here that we probably shouldn't get rid of. Perhaps like

"Permissions": {"name": "contentSettings"}

"Permissions": {
  "name": "cookies",
  "extra": "<a href=\"declare_permissions.html#WHAT_IS_THE_ANCHOR\">host
permissions</a>"
}

all of the extra crap (examples, media galleries specifics, file system
specifics) can go in extra, which is HTML.

[epeterson, 2013/05/13 02:38:10]

Done.

+  ],
+  "debugger": [
+    { "Permissions": "<code>\"debugger\"</code>" }
+  ],
+  "declarativeContent": [
+    { "Permissions": "<code>\"declarativeContent\"</code><!--TODO: Mention host permissions if/when some actions require them.-->" },

[not at google - send to devlin, 2013/04/30 18:34:19]

let's convert the HTML comments into JSON comments (presumably these go through,
or can go through, the json comment eater)

[epeterson, 2013/05/13 02:38:10]

Done.

+    { "Learn more": "<a href='events.html'>Declarative Events</a><br/>The <a href='activeTab.html'>activeTab</a> permission" }
+  ],
+  "declarativeWebRequest": [
+    { "Permissions": "<code>\"declarativeWebRequest\"</code><br><a href=\"declare_permissions.html\">host permissions</a>" }
+  ],
+  "downloads": [
+    { "Permissions": "<code>\"downloads\"</code><br><a href=\"declare_permissions.html\">host permissions</a>" }
+  ],
+  "fileBrowserHandler": [
+    { "Permissions": "<code>\"fileBrowserHandler\"</code>" }
+  ],
+  "fileSystem": [
+    { "Permissions": "<code>\"fileSystem\"</code>, <code>\"fileSystem.write\"</code>" },
+    { "Learn more": "<a href='app_storage.html'>Manage Data</a><br><a href='angular_framework.html'>Build Apps with AngularJS</a><br><a href='https://developers.google.com/live/shows/7320022-1001/'>Chrome Apps Office Hours:TextDrive and AngularJS</a>" }
+  ],
+  "fontSettings": [
+    { "Permissions": "<code>\"fontSettings\"</code>" }
+  ],
+  "history": [
+    { "Permissions": "<code>\"history\"</code>" }
+  ],
+  "idle": [
+    { "Permissions": "<code>\"idle\"</code>" }
+  ],
+  "input_ime": [
+    { "Permissions": "<code>\"input\"</code>" }
+  ],
+  "management": [
+    { "Permissions": "<code>\"management\"</code>" }
+  ],
+  "mediaGalleries": [
+    { "Permissions": "<code>\"mediaGalleries': ['read']\"</code>,<code>\"mediaGalleries': ['read', 'allAutoDetected']\"</code><br>See <a href='#manifest'>Manifest</a> belowfor more information." },
+    { "Learn more": "<a href='https://developers.google.com/live/shows/10479832/'>Chrome Office Hours: The Media Galleries API</a>" }
+  ],
+  "notifications": [
+    { "Permissions": "<code>\"notifications\"</code>" },
+    { "Learn more": "<a href='https://developers.google.com/live/shows/83992232-1001/'>Chrome Apps Office Hours: Rich Notifications</a>" }
+  ],
+  "pageCapture": [
+    { "Permissions": "<code>\"pageCapture\"</code>" }
+  ],
+  "power": [
+    { "Permissions": "<code>\"power\"</code>" }
+  ],
+  "privacy": [
+    { "Permissions": "<code>\"privacy\"</code>" }
+  ],
+  "proxy": [
+    { "Permissions": "<code>\"proxy\"</code>" }
+  ],
+  "pushMessaging": [
+    { "Permissions": "<code>\"pushMessaging\"</code>" },
+    { "Learn more": "<a href='cloudMessaging.html'>Google Cloud Messaging for Chrome</a>;<br><a href='gcm_server.html'>API Reference for GCM service</a>" }
+  ],
+  "runtime": [
+    { "Permissions": "None" },
+    { "Learn more": "<a href='app_lifecycle.html'>Manage App Lifecycle</a><br><a href='event_pages.html'>Event Pages</a>" }
+  ],
+  "serial": [
+    { "Permissions": "<code>\"serial\"</code>" },
+    { "Learn more": "<a href='app_hardware.html'>Accessing Hardware Devices</a>" }
+  ],
+  "socket": [
+    { "Permissions": "<code>\"socket': ['rule1', 'rule2']\"</code><br>For example: <code>\"socket': ['tcp-connect:*:*']\"</code>means connecting on any port of any host.See <a href='app_network.html'>Network Communications</a> for rule syntax." },
+    { "Learn more": "<a href='app_network.html'>Network Communications</a><br><a href='sencha_framework.html'>Build Apps with Sencha ExtJS</a><br><a href='https://developers.google.com/live/shows/7320022-5001/'>Chrome Apps Office Hours: Networking APIs</a><br><a href='https://developers.google.com/live/shows/7320022-2001/'>Chrome Apps Office Hours: Controlling an AR ParrotDrone</a>" }
+  ],
+  "storage": [
+    { "Permissions": "<code>\"storage\"</code>" },
+    { "Learn more": "<a href='https://developers.google.com/live/shows/7320022/'>Chrome Apps Office Hours: Chrome Storage APIs</a><br><a href='https://developers.google.com/live/shows/7320022-1/'>Chrome Apps Office Hours: Storage API Deep Dive</a>" }
+  ],
+  "syncFileSystem": [
+    { "Permissions": "<code>\"syncFileSystem\"</code>" },
+    { "Learn more": "<a href='http://developer.chrome.com/trunk/apps/app_storage.html'>Manage Data</a>;<br><a href='https://developers.google.com/live/shows/83992232-2001/'>Chrome Office Hours: Synched File System</a>" }
+  ],
+  "tabs": [
+    { "Permissions": "<code>\"tabs\"</code>" }
+  ],
+  "topSites": [
+    { "Permissions": "<code>\"topSites\"</code>" }
+  ],
+  "tts": [
+    { "Permissions": "<code>\"tts\"</code>" },
+    { "Learn more": "<a href='https://developers.google.com/live/shows/7320022-7001/'>Chrome Office Hours: Text to Speech API</a>" }
+  ],
+  "ttsEngine": [
+    { "Permissions": "<code>\"ttsEngine\"</code>" }
+  ],
+  "usb": [
+    { "Permissions": "<code>\"usb\"</code>" },
+    { "Learn more": "<a href='app_hardware.html'>Accessing Hardware Devices</a>" }
+  ],
+  "webNavigation": [
+    { "Permissions": "<code>\"webNavigation\"</code>" }
+  ],
+  "webRequest": [
+    { "Permissions": "<code>\"webRequest\"</code><br><a href=\"declare_permissions.html\">host permissions</a>" }
+  ],
+  "webstore": [
+    { "Permissions": "None" },
+    { "Learn more": "<a href='https://developers.google.com/chrome/web-store/docs/inline_installation'>Using Inline Installation</a>" }
+  ],
+  "windows": [
+    { "Permissions": "<code>\"tabs\"</code>" }
+  ] }

[not at google - send to devlin, 2013/04/30 18:34:19]

put the closing } on its own line. sorry.

[epeterson, 2013/05/13 02:38:10]

Done. (sorry.)