More docs reviews (#990)

Author: gregmarr

docs/cpp2/common.md

@@ -92,7 +92,7 @@ Cpp2 supports the same fundamental types as today's Cpp1, but additionally provi
 | `ulonglong`   | `#!cpp unsigned long long`   |
 | `longdouble`  | `#!cpp long double`          |
 
-| For compatibility/interop only,<br> so deliberately ugly names | Synonym for | Notes |
+| For compatibility/interop only,<br> so deliberately ugly names | Synonym for (these multi-word<br> names are not allowed in Cpp2) | Notes |
 |---|---|---|
 | `_schar`     | `#!cpp signed char`   | Normally, prefer `i8` instead |
 | `_uchar`     | `#!cpp unsigned char` | Normally, prefer `u8` instead |

docs/index.md

@@ -9,7 +9,7 @@ main: () = {
 
 ## <a id="what-is-cpp2"></a> What is Cpp2?
 
-"Cpp2," short for "C++ syntax 2," is my ([Herb Sutter's](https://github.com/hsutter)) personal project to try to make writing ordinary C++ types/functions/objects be much **simpler and safer**, without breaking backward compatibility. Bjarne Stroustrup said it best:
+"Cpp2", short for "C++ syntax 2", is my ([Herb Sutter's](https://github.com/hsutter)) personal project to try to make writing ordinary C++ types/functions/objects be much **simpler and safer**, without breaking backward compatibility. Bjarne Stroustrup said it best:
 
 > "Inside C++, there is a much smaller and cleaner language struggling to get out." <br>&emsp;&emsp;— Bjarne Stroustrup, _The Design and Evolution of C++_ (D&E), 1994
 >

docs/welcome/hello-world.md

@@ -93,7 +93,7 @@ auto hello(cpp2::in<std::string_view> msg) -> void {
     std::cout << ("Hello, " + cpp2::to_string(msg) + "!\n");  }
 ```
 
-Here we can see more of how Cpp2 makes it features work.
+Here we can see more of how Cpp2 makes its features work.
 
 **How: Consistent context-free syntax.**
 
@@ -108,15 +108,15 @@ Here we can see more of how Cpp2 makes it features work.
 
 **How: Simplicity through generality + defaults.**
 
-- **Line 7: `in` parameters** are implemented using `#cpp2::in<>`, which is smart enough to pass by `#!cpp const` value when that's safe and appropriate, otherwise by `#!cpp const&`, so you don't have to choose the right one by hand.
+- **Line 7: `in` parameters** are implemented using `#!cpp cpp2::in<>`, which is smart enough to pass by `#!cpp const` value when that's safe and appropriate, otherwise by `#!cpp const&`, so you don't have to choose the right one by hand.
 
 **How: Order-independent by default.**
 
-- **Lines 5 and 7: Order independence** happens because cppfront generates all the type and function forward declarations for you, so you don't have to. That's why `main` can just call `hello`: Both are forward-declared, so they can both see each other.
+- **Lines 5 and 7: Order independence** happens because cppfront generates all the type and function forward declarations for you, so you don't have to. That's why `main` can just call `hello`: both are forward-declared, so they can both see each other.
 
 **How: Seamless compatibility and interop.**
 
-- **Lines 9-11 and 16: Ordinary direct calls** to existing C++ code, so there's never a need for wrapping/marshaling/thunking.
+- **Lines 9-11 and 15: Ordinary direct calls** to existing C++ code, so there's never a need for wrapping/marshaling/thunking.
 
 **How: C++ standard library always available.**
 

docs/welcome/integration.md

@@ -3,6 +3,7 @@
 
 To start trying out Cpp2 syntax in any existing C++ project, just add a build step to translate the Cpp2 to Cpp1 syntax:
 
+- Copy the `.cpp` file to the same name with a `.cpp2` extension.
 - Add the `.cpp2` file to the project, and ensure the `.cpp` is in C++20 mode.
 - Tell the IDE to build that file using a custom build tool to invoke cppfront.