YSLD Documtation fixes

Various fixes to the ysld documentation. See individual commits for more details.

Note: This is in several commits as that there are a number of unrelated changes spread over various pages.