docs: Various grammar / syntax improvements #1245

Job	Run time
type-check	19s
lint	18s
end-to-end-test (ubuntu-20.04, local)	31s
end-to-end-test (ubuntu-20.04, ssh)	1m 26s
unit-test (ubuntu-20.04, 3.7)	1m 12s
end-to-end-test (ubuntu-20.04, docker)	31s
unit-test (ubuntu-20.04, 3.8)	1m 9s
end-to-end-test (ubuntu-latest, local)	38s
unit-test (ubuntu-20.04, 3.9)	1m 6s
end-to-end-test (ubuntu-latest, ssh)	1m 25s
end-to-end-test (ubuntu-latest, docker)	42s
unit-test (ubuntu-20.04, 3.10)	1m 3s
end-to-end-test (macos-latest, local)	27s
unit-test (ubuntu-20.04, 3.11)	1m 5s
unit-test (ubuntu-latest, 3.7)	1m 13s
unit-test (ubuntu-latest, 3.8)	1m 7s
unit-test (ubuntu-latest, 3.9)	1m 12s
unit-test (ubuntu-latest, 3.10)	1m 3s
unit-test (ubuntu-latest, 3.11)	1m 8s
unit-test (macos-12, 3.11)	1m 38s
unit-test (windows-2022, 3.11)	1m 36s
tests-done	1s
	20m 50s

Provide feedback