doc: Address feedback about intro

brson · brson · commit d1eb0e393fb2 · 2014-04-14T20:49:29.000-07:00
diff --git a/src/doc/index.md b/src/doc/index.md
@@ -7,7 +7,7 @@
 li {list-style-type: none; }
 </style>
 
-* [A 30-minute Intro to Rust](intro.html) (read this first)
+* [A 30-minute Intro to Rust](intro.html)
 * [The Rust tutorial](tutorial.html)  (* [PDF](tutorial.pdf))
 * [The Rust reference manual](rust.html) (* [PDF](rust.pdf))
 
diff --git a/src/doc/intro.md b/src/doc/intro.md
@@ -36,6 +36,9 @@ int add_one(void)
 }
 ```
 
+**Note: obviously this is very simple and non-idiomatic C++.
+You wouldn't write it in practice; it is for illustrative purposes.**
+
 This function allocates an integer on the stack,
 and stores it in a variable, `i`.
 It then returns a reference to the variable `i`.

Original file line number	Diff line number	Diff line change
`@@ -36,6 +36,9 @@ int add_one(void)`
`36`	`36`	`}`
`37`	`37`	```
`38`	`38`
	`39`	`+**Note: obviously this is very simple and non-idiomatic C++.`
	`40`	`+You wouldn't write it in practice; it is for illustrative purposes.**`
	`41`	`+`
`39`	`42`	`This function allocates an integer on the stack,`
`40`	`43`	and stores it in a variable, `i`.
`41`	`44`	It then returns a reference to the variable `i`.