Originally written by @McJones, and copied from his Gist here: https://gist.github.com/McJones/d9a9570cd4dcbb23746c23903d8bfe59

… some more common aliases.

In particular linked everything (I think) that should be linked.
Clarified various elements.
Reordered numerous sections to better flow.

This fixes them looking weird on certain browsers/programs.
Does have the side effect of making each way bigger than they were before, oh well.

Mars yarn spec changes into yarn-spec

As it was it implied that escaped text needed to be handled inside of comments,
when what we want to say is you can escape comments if you need to.

This is a point to come back to I reckon.
People may well have opinions on this.

As it previously existed while it was a valid approach and technically what we do in Yarn Spinner it was very rigid and requires a two pass approach.
There is no reason that a fully type inferred version of Yarn doing this all line by line at runtime couldn't exist (assuming people use variables) properly and this would require no declarations.

The errors still exist for using variables that don't match their type.

The previous one technically required at least one parameter