add back dart:mirrors content, remove dart:isolate, misc. tweaks/updates

add back dart:mirrors content, remove dart:isolate, misc. tweaks/updates

staged at:
https://book-dot-dart-lang.appspot.com/docs/dart-up-and-running/

R=sethladd@google.com

Committed: 1c17ea4

[sethladd, 2013-12-04 19:06:01]

lgtm once we add the warning for @MirrorsUsed

https://chromiumcodereview.appspot.com/103483002/diff/20001/ch00.xml
File ch00.xml (right):

https://chromiumcodereview.appspot.com/103483002/diff/20001/ch00.xml#newcode213
ch00.xml:213: Use <literal>static const</literal> variables instead.</para>
you said instance variables, but you mention static here.

https://chromiumcodereview.appspot.com/103483002/diff/20001/ch03.xml
File ch03.xml (right):

https://chromiumcodereview.appspot.com/103483002/diff/20001/ch03.xml#newcode2676
ch03.xml:2676:
url="http://api.dartlang.org/dart_mirrors/MirrorsUsed.html">MirrorsUsed</ulink>
let's put a warning in and explain why and when you'd use this

[Kathy Walrath, 2013-12-04 19:29:47]

Committed patchset #3 manually as r1c17ea4 (presubmit successful).

[Emily Fortuna, 2013-12-05 21:55:11]

https://chromiumcodereview.appspot.com/103483002/diff/40001/ch03.xml
File ch03.xml (right):

https://chromiumcodereview.appspot.com/103483002/diff/40001/ch03.xml#newcode1242
ch03.xml:1242: <para>The Math library provides optimized
<literal>max()</literal> and
what do you mean by "optimized" methods here?

https://chromiumcodereview.appspot.com/103483002/diff/40001/ch03.xml#newcode1318
ch03.xml:1318: <para>For scalable, higher level approaches to web app UIs, see
<ulink
might consider removing "scalable" ... that seems to suggest that the dart:html
library is not really a viable option to use on its own (yes, obviously Polymer
helps make it better, but we don't want to suggest that dart:html is not good to
work with directly)

https://chromiumcodereview.appspot.com/103483002/diff/40001/ch03.xml#newcode1345
ch03.xml:1345: <literal moreinfo="none">document</literal> property (a Document
Consider just saying "Document object" instead of "property (a Document
object)". Users can determine it's a property by looking at the documentation,
and it's assumed if the Window has it, you can access it in some way.

https://chromiumcodereview.appspot.com/103483002/diff/40001/ch03.xml#newcode1348
ch03.xml:1348: data), <literal>requestAnimationFrame()</literal> (for
animations), and
actually the current Dart idiom is to use "animationFrame"
https://api.dartlang.org/docs/channels/be/latest/dart_html/Window.html#animat...
which returns a Future, when possible.

https://chromiumcodereview.appspot.com/103483002/diff/40001/ch03.xml#newcode1439
ch03.xml:1439: </remark>&lt;!-- In HTML: --&gt;
consider formatting the html and the dart code into separate boxes since you
can't paste the whole thing into a single file as written.

https://chromiumcodereview.appspot.com/103483002/diff/40001/ch03.xml#newcode1491
ch03.xml:1491: <para>Note that elem2 is a ParagraphElement in the above
"Note that elem2 is also a ParagraphElement object in..."

https://chromiumcodereview.appspot.com/103483002/diff/40001/ch03.xml#newcode1491
ch03.xml:1491: <para>Note that elem2 is a ParagraphElement in the above
"Note that elem2 is also a ParagraphElement object in..."

https://chromiumcodereview.appspot.com/103483002/diff/40001/ch03.xml#newcode1512
ch03.xml:1512: List&lt;Node&gt;. Once you have this list, you can use the usual
List
maybe add "as opposed to 'children' which just returns the child elements."

https://chromiumcodereview.appspot.com/103483002/diff/40001/ch03.xml#newcode1574
ch03.xml:1574: ..id = 'message2'
stylistic note: at google, when the line is a method cascade, we only indent +2
spaces from the previous line rather than the 4

https://chromiumcodereview.appspot.com/103483002/diff/40001/ch03.xml#newcode1760
ch03.xml:1760: <para>The general flow for using the full API of HttpRequest is
as
maybe just condense this list into a sentence. Given its position on the page it
stands out a lot, and I'm not sure it's *that* important relative to explaining
the main usage with FUtures. ALso you see it in the code example below

[Kathy Walrath, 2013-12-13 00:48:20]

Finally incorporated Emily's comments (except for a few, notably cascade
indentation, which really should be 4 spaces).

Thanks, Emily!

https://chromiumcodereview.appspot.com/103483002/diff/40001/ch03.xml
File ch03.xml (right):

https://chromiumcodereview.appspot.com/103483002/diff/40001/ch03.xml#newcode1242
ch03.xml:1242: <para>The Math library provides optimized
<literal>max()</literal> and
On 2013/12/05 21:55:11, Emily Fortuna wrote:
> what do you mean by "optimized" methods here?

Done.

https://chromiumcodereview.appspot.com/103483002/diff/40001/ch03.xml#newcode1318
ch03.xml:1318: <para>For scalable, higher level approaches to web app UIs, see
<ulink
On 2013/12/05 21:55:11, Emily Fortuna wrote:
> might consider removing "scalable" ... that seems to suggest that the
dart:html
> library is not really a viable option to use on its own (yes, obviously
Polymer
> helps make it better, but we don't want to suggest that dart:html is not good
to
> work with directly)

Done.

https://chromiumcodereview.appspot.com/103483002/diff/40001/ch03.xml#newcode1345
ch03.xml:1345: <literal moreinfo="none">document</literal> property (a Document
On 2013/12/05 21:55:11, Emily Fortuna wrote:
> Consider just saying "Document object" instead of "property (a Document
> object)". Users can determine it's a property by looking at the documentation,
> and it's assumed if the Window has it, you can access it in some way.

Done.

https://chromiumcodereview.appspot.com/103483002/diff/40001/ch03.xml#newcode1348
ch03.xml:1348: data), <literal>requestAnimationFrame()</literal> (for
animations), and
On 2013/12/05 21:55:11, Emily Fortuna wrote:
> actually the current Dart idiom is to use "animationFrame"
>
https://api.dartlang.org/docs/channels/be/latest/dart_html/Window.html#animat...
> which returns a Future, when possible.

I switched to not use the () and code font, since I wanted to refer to the API
in general, not to our implementation of the API.

https://chromiumcodereview.appspot.com/103483002/diff/40001/ch03.xml#newcode1512
ch03.xml:1512: List&lt;Node&gt;. Once you have this list, you can use the usual
List
On 2013/12/05 21:55:11, Emily Fortuna wrote:
> maybe add "as opposed to 'children' which just returns the child elements."

Done.

https://chromiumcodereview.appspot.com/103483002/diff/40001/ch03.xml#newcode1574
ch03.xml:1574: ..id = 'message2'
On 2013/12/05 21:55:11, Emily Fortuna wrote:
> stylistic note: at google, when the line is a method cascade, we only indent
+2
> spaces from the previous line rather than the 4

I had to look this one up. According to
https://code.google.com/p/dart/issues/detail?id=8175, the style guide has been
amended to specify 4 spaces for cascades:

https://www.dartlang.org/articles/style-guide/#do-use-four-spaces-for-method-...