Per P0 reqs add launch pts + make download obvious. Also misc cpy edits.

Per P0 reqs add launch points + make download obvious. Also misc copy edits.

BUG=none
R= mkearney@chromium.org, smain@chromium.org, binji@chromium.org
TEST=none
NOTRY=true
(documentation only change)

Priority list copied here for reference: 
P1 But written by different engineers, very uneven quality and voice.
P2 Some documentation could be expanded.
P0 The ramp-in for new users could be improved.
P0 The landing page isn't "cool", it doesn't make developers want to jump in and use it.
    Could we have a more github-like thing that gets people started quickly?
    Could we have a narrative intro?
    We just bought the pna.cl domain, we should use it!
P3 We think it's pretty important to keep the deep-dive in there (e.g. sandbox internals, bitcode reference).

Committed: https://crrev.com/d8030556408b675d29fd0446a10eeba50b2a2c84
Cr-Commit-Position: refs/heads/master@{#291696}

[jpmedley, 2014-08-18 15:01:08]

More changes later.

[mkearney1, 2014-08-18 21:57:34]

First quick review:

-- Getting trailing whitespace errors when I take on the patch, so the patch
fails. Need to investigate if this is in output or if there is some way to
control it in input.

-- Still need to test navigation (can't build patch with errors as is).

-- Like the new intro.

-- One comment that looks like some text needs to be removed... see below.

https://codereview.chromium.org/476793002/diff/1/native_client_sdk/doc_genera...
File native_client_sdk/doc_generated/pepper_stable/pepper-api.html (right):

https://codereview.chromium.org/476793002/diff/1/native_client_sdk/doc_genera...
native_client_sdk/doc_generated/pepper_stable/pepper-api.html:6: cross-platform
C/C++ API for web browser plugins. From the point of view of
I'm guessing Latin isn't meant to stay in here?

[jpmedley, 2014-08-19 00:13:18]

https://codereview.chromium.org/476793002/diff/1/native_client_sdk/doc_genera...
File native_client_sdk/doc_generated/pepper_stable/pepper-api.html (right):

https://codereview.chromium.org/476793002/diff/1/native_client_sdk/doc_genera...
native_client_sdk/doc_generated/pepper_stable/pepper-api.html:6: cross-platform
C/C++ API for web browser plugins. From the point of view of
On 2014/08/18 21:57:34, mkearney1 wrote:
> I'm guessing Latin isn't meant to stay in here?

This file wasn't even supposed to part of the CL. I'll fix it.

[jpmedley, 2014-08-19 00:57:14]

PTAL

[binji, 2014-08-19 19:22:35]

https://codereview.chromium.org/476793002/diff/20001/native_client_sdk/doc_ge...
File native_client_sdk/doc_generated/community/index.html (right):

https://codereview.chromium.org/476793002/diff/20001/native_client_sdk/doc_ge...
native_client_sdk/doc_generated/community/index.html:6:
<strong>implementors</strong> (contributors to the <a class="reference external"
href="nacl_project_">open-source Native Client project</a>) and
<strong>developers</strong>, who use Native Client to develop web
this should be reverted. Not sure why sphinx is doing this.

https://codereview.chromium.org/476793002/diff/20001/native_client_sdk/src/do...
File native_client_sdk/src/doc/c-api.rst (right):

https://codereview.chromium.org/476793002/diff/20001/native_client_sdk/src/do...
native_client_sdk/src/doc/c-api.rst:1: .. _c-api:
did you determine if this is necessary? I think you may be able to achieve this
effect without adding these new files, just by changing the chrome_sidenav.json

https://codereview.chromium.org/476793002/diff/20001/native_client_sdk/src/do...
File native_client_sdk/src/doc/overview.rst (right):

https://codereview.chromium.org/476793002/diff/20001/native_client_sdk/src/do...
native_client_sdk/src/doc/overview.rst:50: * **Graphics, audio, and much more:**
Runing native code modules that render 2D
sp: Running

https://codereview.chromium.org/476793002/diff/20001/native_client_sdk/src/do...
native_client_sdk/src/doc/overview.rst:106: Native Client is an umbrella name
for a set of related software components that
I think "work" is still needed

https://codereview.chromium.org/476793002/diff/20001/native_client_sdk/src/do...
File native_client_sdk/src/doc/sdk/download.rst (right):

https://codereview.chromium.org/476793002/diff/20001/native_client_sdk/src/do...
native_client_sdk/src/doc/sdk/download.rst:196: If you run the "``naclsdk
update``" now, it will warn you with a message
remove "the"?

https://codereview.chromium.org/476793002/diff/20001/native_client_sdk/src/do...
File native_client_sdk/src/doc/sdk/examples.rst (right):

https://codereview.chromium.org/476793002/diff/20001/native_client_sdk/src/do...
native_client_sdk/src/doc/sdk/examples.rst:24: If you are using Chrome 31 or
later, you can skip this section.
We may want to remove this section. Chrome 31 is pretty old now.

https://codereview.chromium.org/476793002/diff/20001/native_client_sdk/src/do...
File native_client_sdk/src/doc/sitemap.rst (right):

https://codereview.chromium.org/476793002/diff/20001/native_client_sdk/src/do...
native_client_sdk/src/doc/sitemap.rst:46: c-api.rst
if you do need these, remember to add them to the CL. They are currently not
uploaded

[jpmedley, 2014-08-19 20:13:01]

@binji,

PTAL

https://codereview.chromium.org/476793002/diff/20001/native_client_sdk/doc_ge...
File native_client_sdk/doc_generated/community/index.html (right):

https://codereview.chromium.org/476793002/diff/20001/native_client_sdk/doc_ge...
native_client_sdk/doc_generated/community/index.html:6:
<strong>implementors</strong> (contributors to the <a class="reference external"
href="nacl_project_">open-source Native Client project</a>) and
<strong>developers</strong>, who use Native Client to develop web
On 2014/08/19 19:22:34, binji wrote:
> this should be reverted. Not sure why sphinx is doing this.

Done.

https://codereview.chromium.org/476793002/diff/20001/native_client_sdk/src/do...
File native_client_sdk/src/doc/c-api.rst (right):

https://codereview.chromium.org/476793002/diff/20001/native_client_sdk/src/do...
native_client_sdk/src/doc/c-api.rst:1: .. _c-api:
On 2014/08/19 19:22:34, binji wrote:
> did you determine if this is necessary? I think you may be able to achieve
this
> effect without adding these new files, just by changing the
chrome_sidenav.json

When I do the I don't get the correct navigation. Ping me about this and I'll
shoot you a screen shot.

https://codereview.chromium.org/476793002/diff/20001/native_client_sdk/src/do...
File native_client_sdk/src/doc/overview.rst (right):

https://codereview.chromium.org/476793002/diff/20001/native_client_sdk/src/do...
native_client_sdk/src/doc/overview.rst:50: * **Graphics, audio, and much more:**
Runing native code modules that render 2D
On 2014/08/19 19:22:34, binji wrote:
> sp: Running

Done.

https://codereview.chromium.org/476793002/diff/20001/native_client_sdk/src/do...
native_client_sdk/src/doc/overview.rst:106: Native Client is an umbrella name
for a set of related software components that
On 2014/08/19 19:22:34, binji wrote:
> I think "work" is still needed

I got interrupted during the edit, looks like.

https://codereview.chromium.org/476793002/diff/20001/native_client_sdk/src/do...
File native_client_sdk/src/doc/sdk/download.rst (right):

https://codereview.chromium.org/476793002/diff/20001/native_client_sdk/src/do...
native_client_sdk/src/doc/sdk/download.rst:196: If you run the "``naclsdk
update``" now, it will warn you with a message
On 2014/08/19 19:22:34, binji wrote:
> remove "the"?

Done.

https://codereview.chromium.org/476793002/diff/20001/native_client_sdk/src/do...
File native_client_sdk/src/doc/sdk/examples.rst (right):

https://codereview.chromium.org/476793002/diff/20001/native_client_sdk/src/do...
native_client_sdk/src/doc/sdk/examples.rst:24: If you are using Chrome 31 or
later, you can skip this section.
On 2014/08/19 19:22:34, binji wrote:
> We may want to remove this section. Chrome 31 is pretty old now.

Acknowledged.

https://codereview.chromium.org/476793002/diff/20001/native_client_sdk/src/do...
File native_client_sdk/src/doc/sitemap.rst (right):

https://codereview.chromium.org/476793002/diff/20001/native_client_sdk/src/do...
native_client_sdk/src/doc/sitemap.rst:46: c-api.rst
On 2014/08/19 19:22:34, binji wrote:
> if you do need these, remember to add them to the CL. They are currently not
> uploaded

Actually, they are.

[binji, 2014-08-19 20:53:16]

OK, lgtm

https://codereview.chromium.org/476793002/diff/20001/native_client_sdk/src/do...
File native_client_sdk/src/doc/c-api.rst (right):

https://codereview.chromium.org/476793002/diff/20001/native_client_sdk/src/do...
native_client_sdk/src/doc/c-api.rst:1: .. _c-api:
On 2014/08/19 20:13:01, jmedley wrote:
> On 2014/08/19 19:22:34, binji wrote:
> > did you determine if this is necessary? I think you may be able to achieve
> this
> > effect without adding these new files, just by changing the
> chrome_sidenav.json
> 
> When I do the I don't get the correct navigation. Ping me about this and I'll
> shoot you a screen shot.

OK, this is fine then.

https://codereview.chromium.org/476793002/diff/20001/native_client_sdk/src/do...
File native_client_sdk/src/doc/sitemap.rst (right):

https://codereview.chromium.org/476793002/diff/20001/native_client_sdk/src/do...
native_client_sdk/src/doc/sitemap.rst:46: c-api.rst
On 2014/08/19 20:13:01, jmedley wrote:
> On 2014/08/19 19:22:34, binji wrote:
> > if you do need these, remember to add them to the CL. They are currently not
> > uploaded
> 
> Actually, they are.

Oops, you're right.

[jpmedley, 2014-08-25 16:01:10]

The CQ bit was checked by jmedley@chromium.org

[jpmedley, 2014-08-25 16:01:18]

The CQ bit was unchecked by jmedley@chromium.org

[jpmedley, 2014-08-25 16:06:09]

The CQ bit was checked by jmedley@chromium.org

[commit-bot: I haz the power, 2014-08-25 16:06:40]

CQ is trying da patch. Follow status at
 https://chromium-status.appspot.com/cq/jmedley@chromium.org/476793002/60001

[jpmedley, 2014-08-25 16:07:23]

The CQ bit was unchecked by jmedley@chromium.org

[commit-bot: I haz the power, 2014-08-25 16:08:12]

The CQ bit was unchecked by commit-bot@chromium.org

[jpmedley, 2014-08-25 16:40:02]

The CQ bit was checked by jmedley@chromium.org

[commit-bot: I haz the power, 2014-08-25 16:40:52]

CQ is trying da patch. Follow status at
 https://chromium-status.appspot.com/cq/jmedley@chromium.org/476793002/80001

[commit-bot: I haz the power, 2014-08-25 16:42:16]

Committed patchset #5 (80001) as bb5e3bb50ed3fe955ffdef4d7f52006546e460db

[commit-bot: I haz the power, 2014-09-10 02:35:00]

Patchset 5 (id:??) landed as
https://crrev.com/d8030556408b675d29fd0446a10eeba50b2a2c84
Cr-Commit-Position: refs/heads/master@{#291696}