Update disclaimer to improve clarity and intent

hugo · hugo · commit e567d4320365 · 2014-07-01T09:50:55.000+01:00
diff --git a/src/doc/intro.md b/src/doc/intro.md
@@ -36,8 +36,8 @@ 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.**
+**Note: The above C++ code is deliberately simple and non-idiomatic for the purpose
+of demonstration. It is not representative of production-quality C++ code.**
 
 This function allocates an integer on the stack,
 and stores it in a variable, `i`.

Original file line number	Diff line number	Diff line change
`@@ -36,8 +36,8 @@ 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.**`
	`39`	`+**Note: The above C++ code is deliberately simple and non-idiomatic for the purpose`
	`40`	`+of demonstration. It is not representative of production-quality C++ code.**`
`41`	`41`
`42`	`42`	`This function allocates an integer on the stack,`
`43`	`43`	and stores it in a variable, `i`.