Co-authored-by: Thibaud Colas <thibaudcolas@gmail.com>
Also includes:
- Further tone updates based on Vale
- Address other feedback to earlier parts of the tutorial
- apply general fixes to existing markdown documentation
- various cases of rst syntax still used
- update some links to be the new format
- clean up line breaks (prettier)