[fidl] Update docs now that |status| is not reserved

Test: Just changes docs
Change-Id: Id163f430c0faa3d68564dfc9f3862e298cd6806e

[fidl][docs] Make the examples consistent with fidl readability

Test: looked at the rendered markdown
Change-Id: I943b06d9c448ec89b7b74866390de2349135469b

[fidl][docs] Add 'status' to reserved keywords

Test: Opened language.md in browser extension, verified change and
preservation of formatting.

Change-Id: Iae8e48de530d5a009b84810df7ad7f6234e52b4f

[fidl][docs] Fix tiny typos

Change-Id: Id9d1de76aef0177f120ecf6563baff5b35b1f2e1

[fidl] Disallow empty enums

Change-Id: I8db20696ec537e895f8fb2ad17c67b2a735f5a03

[fidl][doc] Remove some chatter from the language description

Change-Id: Ib876b65e839ec59e17b5f48e107d3032da16f207

[fidl] Remove nested declarations

FIDL-188 #done

Change-Id: I8fbcce98ed8fa81f4c91a99f062b8e129c4e5124

[fidl][docs] Clean up some formatting and language

Change-Id: Ie7f43a83232fd15baa639788a6deef55c9071d99

[fidl][docs] Refer to fidl as fidl, not fidl2

Change-Id: Id67dc99b0819388586bd43b0794474dfb908f0d5

[fidl][docs] List array as a keyword

Change-Id: I91c2bfee5330322e83deb560ec2253d00a928970

[fidl][docs] Correct enum separator in docs

FIDL2 separates enum values with semicolons, but the docs indicated
commas. This corrects the docs to match the implementation.

Change-Id: I2923165556568b59a738c85476e08c90f843759d

[docs][fidl] Remove some cruft from fidl docs

While the implementation is in progress, the design more-or-less is
not.

Change-Id: If8cc17c99db63545b799d0d11a8337a018288bf1

[fidl] Remove C-style comments

These are essentially unused in existing fidl1 files.

They also invite suprising behavior, as true C-style comments do not
nest.

The only use I can think of is quickly commenting out large blocks of
code, which can be done easily enough with per-line comments by modern
editors, and which I don't want to see checked in in any case.

Change-Id: Ida2a10cd288f2878362e27d6967fdc80bae7ff4f

[fidl] Disallow empty structs

These are problematic to represent in C and C++. Most people who want
them can work around this with a dummy field, for now.

Change-Id: Ic5c6dba0d2a45a2e26193c3c4f4cb188f5e24c86

[fidl][docs] Remove some dead things from the docs

Change-Id: I650642ac95ea5dcfa178f1e5a6f0afc6225651f8

[fidl] Disallow empty unions

An empty union has no valid wire format representations. A void type
makes little sense in an IPC protocol.

Change-Id: I27b55520f0763dc3cfab6ed2e61adf4a8ec96115

[fidl] Tweak the syntax of event methods

Several people have found this syntax's symmetry with the other method
styles considerably more intuitive than the event keyword.

Change-Id: I75c4d8e88db01cb856d5025dd3eb2e29f50d6eaa

[fidl][docs] Correct some syntax in examples

Change-Id: Ic6826b7c347d363e35b33a2a87ea442d39336532

[fidl] Fix bad markdown in fidl language doc.

Change-Id: Icafa9602242f5b583dc4229a468d312ef16d0df6

[docs][fidl] Disallow the zero ordinal

It's too easy for clients to send the zero ordinal by mistake. It should
be an error.

Change-Id: I7b72fd6ad9dddc57eed06e810a1f03f27c320563

[fidl][docs] Define arrays to have a positive number of elements

Change-Id: I1280f7b453d0409b6322b68bc4a992bb11c12239

[fidl][docs] Update docs to match the FIDL2 examples.

Change-Id: I09578c0728c12fcfeb65081390fb91862ae20d5e

[fidl][docs] 'package' was renamed to 'library', so fix the docs

Change-Id: Ibd8d8515bc2ca8f2a6de6c89e83481645529ef3e

[docs][fidl] Create FIDL markdown documents.

These were converted from google docs automatically, then fixed up
manually.

Note these may not be up to date. kulakowski@ will work on updating them
when he gets back from vacation.

TO-321

Change-Id: If974bcb00a46bfe605a1005287b7b31df717f427