Reorganize/rewrite the Mojom IDL intro.

Reorganize/rewrite the Mojom IDL intro.

I copied the old intro/outline to mojom_lang/mojom_lang.md (to
reorganize later -- it should be reference-ish in nature). And I made
intro/mojom_idl.md a briefer (and less formal) overview of (some of) the
more important points about Mojom IDL.

(Still left to write for intro/mojom_idl.md: stuff about consts and
annotations.)

R=vardhan@google.com

Committed: https://chromium.googlesource.com/external/mojo/+/c7f9e258b4eaa5f71908400e9630777db52afd03

[vardhan, 2016-03-08 00:41:24]

lgtm w/ clarification

you have some common text between the two files, which seems like it would be
annoying to maintain?  i.e., having to edit the same thing in two places.

https://codereview.chromium.org/1769863003/diff/1/docs/intro/mojom_idl.md
File docs/intro/mojom_idl.md (right):

https://codereview.chromium.org/1769863003/diff/1/docs/intro/mojom_idl.md#new...
docs/intro/mojom_idl.md:226: There are the "raw" *handle* types, which
correspond to sending Mojo handles
not sure what you mean by "correspond to sending Mojo handles"

[viettrungluu, 2016-03-08 16:00:13]

Thanks.

On 2016/03/08 00:41:24, vardhan wrote:
> lgtm w/ clarification
> 
> you have some common text between the two files, which seems like it would be
> annoying to maintain?  i.e., having to edit the same thing in two places.

As indicated in the CL description, this is a temporary situation.

> 
> https://codereview.chromium.org/1769863003/diff/1/docs/intro/mojom_idl.md
> File docs/intro/mojom_idl.md (right):
> 
>
https://codereview.chromium.org/1769863003/diff/1/docs/intro/mojom_idl.md#new...
> docs/intro/mojom_idl.md:226: There are the "raw" *handle* types, which
> correspond to sending Mojo handles
> not sure what you mean by "correspond to sending Mojo handles"

Clarified, I think.

[viettrungluu, 2016-03-08 16:00:53]

Description was changed from

==========
Reorganize/rewrite the Mojom IDL intro.

I copied the old intro/outline to mojom_lang/mojom_lang.md (to
reorganize later -- it should be reference-ish in nature). And I made
intro/mojom_idl.md a briefer (and less formal) overview of (some of) the
more important points about Mojom IDL.

(Still left to write for intro/mojom_idl.md: stuff about consts and
annotations.)

R=vardhan@google.com
==========

to

==========
Reorganize/rewrite the Mojom IDL intro.

I copied the old intro/outline to mojom_lang/mojom_lang.md (to
reorganize later -- it should be reference-ish in nature). And I made
intro/mojom_idl.md a briefer (and less formal) overview of (some of) the
more important points about Mojom IDL.

(Still left to write for intro/mojom_idl.md: stuff about consts and
annotations.)

R=vardhan@google.com

Committed:
https://chromium.googlesource.com/external/mojo/+/c7f9e258b4eaa5f71908400e963...
==========

[viettrungluu, 2016-03-08 16:00:54]

Committed patchset #2 (id:20001) manually as
c7f9e258b4eaa5f71908400e9630777db52afd03 (presubmit successful).