Add intro to any Chrome app API that has nothing in place already.

Add intro to any Chrome app API with no overview docs.

This intro has a very brief description of the API usage and a link to any related docs,
if available.

At the moment, the related docs are in the heading 4.
In a separate cl, I will add 'Availabile in' information, and may use a table format for both related doc and available in.

This cl also includes broken link fixes to app_hardware.html.

Note: this does not include experimental APIs or APIs with existing intros.
Additional improvements to be made in separate cls.

Committed: https://src.chromium.org/viewvc/chrome?view=rev&revision=170567

[saroop, 2012-11-20 22:17:30]

https://codereview.chromium.org/11412117/diff/1/chrome/common/extensions/docs...
File chrome/common/extensions/docs/templates/articles/app_hardware.html (right):

https://codereview.chromium.org/11412117/diff/1/chrome/common/extensions/docs...
chrome/common/extensions/docs/templates/articles/app_hardware.html:5: This doc
shows you how packaged apps can connect to USB devices
Should we mention Bluetooth here as well ?

https://codereview.chromium.org/11412117/diff/1/chrome/common/extensions/docs...
chrome/common/extensions/docs/templates/articles/app_hardware.html:13: we've
include a link to a bluetooth sample below.
"we've included"

https://codereview.chromium.org/11412117/diff/1/chrome/common/extensions/docs...
File chrome/common/extensions/docs/templates/intros/app_window.html (right):

https://codereview.chromium.org/11412117/diff/1/chrome/common/extensions/docs...
chrome/common/extensions/docs/templates/intros/app_window.html:13: <li><a
href="about_apps.html#look">"How they look"</a></li>
Should "How they look" be within quotes?

[mkearney1, 2012-11-20 22:27:11]

Sriram, your chromium email came up this time.

https://chromiumcodereview.appspot.com/11412117/diff/1/chrome/common/extensio...
File chrome/common/extensions/docs/templates/articles/app_hardware.html (right):

https://chromiumcodereview.appspot.com/11412117/diff/1/chrome/common/extensio...
chrome/common/extensions/docs/templates/articles/app_hardware.html:5: This doc
shows you how packaged apps can connect to USB devices
I've a short mention of Bluetooth here. We need to do a major job on Bluetooth
docs. At the moment, it's only working on ChromeOS.
On 2012/11/20 22:17:30, saroop wrote:
> Should we mention Bluetooth here as well ?

https://chromiumcodereview.appspot.com/11412117/diff/1/chrome/common/extensio...
chrome/common/extensions/docs/templates/articles/app_hardware.html:13: we've
include a link to a bluetooth sample below.
On 2012/11/20 22:17:30, saroop wrote:
> "we've included"

Done.

https://chromiumcodereview.appspot.com/11412117/diff/1/chrome/common/extensio...
File chrome/common/extensions/docs/templates/intros/app_window.html (right):

https://chromiumcodereview.appspot.com/11412117/diff/1/chrome/common/extensio...
chrome/common/extensions/docs/templates/intros/app_window.html:13: <li><a
href="about_apps.html#look">"How they look"</a></li>
On 2012/11/20 22:17:30, saroop wrote:
> Should "How they look" be within quotes?

Done.

[miket_OOO, 2012-11-28 19:21:22]

lgtm

https://codereview.chromium.org/11412117/diff/5001/chrome/common/extensions/d...
File chrome/common/extensions/docs/templates/articles/app_hardware.html (right):

https://codereview.chromium.org/11412117/diff/5001/chrome/common/extensions/d...
chrome/common/extensions/docs/templates/articles/app_hardware.html:13: we've
included a link to a bluetooth sample below.
I think that as a rule, "Bluetooth" in prose should be capitalized.

https://codereview.chromium.org/11412117/diff/5001/chrome/common/extensions/d...
File chrome/common/extensions/docs/templates/intros/bluetooth.html (right):

https://codereview.chromium.org/11412117/diff/5001/chrome/common/extensions/d...
chrome/common/extensions/docs/templates/intros/bluetooth.html:3: to connect to a
bluetooth device.
et seq.

https://codereview.chromium.org/11412117/diff/5001/chrome/common/extensions/d...
File chrome/common/extensions/docs/templates/intros/fileSystem.html (right):

https://codereview.chromium.org/11412117/diff/5001/chrome/common/extensions/d...
chrome/common/extensions/docs/templates/intros/fileSystem.html:9: a
photo-sharing app can use the API
This isn't a fantastic example because we'd want people to consider the
mediaGalleries API instead. How about a text editor, which allows the API to
read and write local documents?

https://codereview.chromium.org/11412117/diff/5001/chrome/common/extensions/d...
File chrome/common/extensions/docs/templates/intros/serial.html (right):

https://codereview.chromium.org/11412117/diff/5001/chrome/common/extensions/d...
chrome/common/extensions/docs/templates/intros/serial.html:3: to read and write
from a serial device.
Up to you, but "serial device" isn't very precise to me. I'd prefer to see
something like "a serial port" or perhaps "a device connected to a serial port."

https://codereview.chromium.org/11412117/diff/5001/chrome/common/extensions/d...
File chrome/common/extensions/docs/templates/intros/usb.html (right):

https://codereview.chromium.org/11412117/diff/5001/chrome/common/extensions/d...
chrome/common/extensions/docs/templates/intros/usb.html:3: to send messages to
any connected device.
Would you ask gdk@ for his opinion about this statement? I suspect it's overly
broad, but I'm not sure how to properly limit it.

[mkearney1, 2012-11-30 21:42:59]

https://codereview.chromium.org/11412117/diff/5001/chrome/common/extensions/d...
File chrome/common/extensions/docs/templates/articles/app_hardware.html (right):

https://codereview.chromium.org/11412117/diff/5001/chrome/common/extensions/d...
chrome/common/extensions/docs/templates/articles/app_hardware.html:13: we've
included a link to a bluetooth sample below.
On 2012/11/28 19:21:22, miket wrote:
> I think that as a rule, "Bluetooth" in prose should be capitalized.

Done.

https://codereview.chromium.org/11412117/diff/5001/chrome/common/extensions/d...
File chrome/common/extensions/docs/templates/intros/bluetooth.html (right):

https://codereview.chromium.org/11412117/diff/5001/chrome/common/extensions/d...
chrome/common/extensions/docs/templates/intros/bluetooth.html:3: to connect to a
bluetooth device.
On 2012/11/28 19:21:22, miket wrote:
> et seq.

Done.

https://codereview.chromium.org/11412117/diff/5001/chrome/common/extensions/d...
File chrome/common/extensions/docs/templates/intros/fileSystem.html (right):

https://codereview.chromium.org/11412117/diff/5001/chrome/common/extensions/d...
chrome/common/extensions/docs/templates/intros/fileSystem.html:9: a
photo-sharing app can use the API
On 2012/11/28 19:21:22, miket wrote:
> This isn't a fantastic example because we'd want people to consider the
> mediaGalleries API instead. How about a text editor, which allows the API to
> read and write local documents?

Done.

https://codereview.chromium.org/11412117/diff/5001/chrome/common/extensions/d...
File chrome/common/extensions/docs/templates/intros/serial.html (right):

https://codereview.chromium.org/11412117/diff/5001/chrome/common/extensions/d...
chrome/common/extensions/docs/templates/intros/serial.html:3: to read and write
from a serial device.
On 2012/11/28 19:21:22, miket wrote:
> Up to you, but "serial device" isn't very precise to me. I'd prefer to see
> something like "a serial port" or perhaps "a device connected to a serial
port."

Done.

https://codereview.chromium.org/11412117/diff/5001/chrome/common/extensions/d...
File chrome/common/extensions/docs/templates/intros/usb.html (right):

https://codereview.chromium.org/11412117/diff/5001/chrome/common/extensions/d...
chrome/common/extensions/docs/templates/intros/usb.html:3: to send messages to
any connected device.
On 2012/11/28 19:21:22, miket wrote:
> Would you ask gdk@ for his opinion about this statement? I suspect it's overly
> broad, but I'm not sure how to properly limit it.

Done.

[miket_OOO, 2012-11-30 21:56:52]

LGTM after fixing one major issue.

https://codereview.chromium.org/11412117/diff/11017/chrome/common/extensions/...
File chrome/common/extensions/docs/templates/intros/serial.html (right):

https://codereview.chromium.org/11412117/diff/11017/chrome/common/extensions/...
chrome/common/extensions/docs/templates/intros/serial.html:3: to read to and
write from a device connected to a serial port.
whoops! "read from and write to"