Add a document describing our environment variable usage.

[grynspan]

Adds a document describing our environment variable usage for reference by developers working on Swift Testing.

This document is not an API contract: the set of environment variables Swift Testing uses may change at any time.

Checklist:

• Code and documentation should follow the style of the Style Guide.
• If public symbols are renamed or modified, DocC references should be updated.

[heckj]

Suggested change

	This document lists the environment variables that Swift Testing currently uses.
	This document lists the environment variables that Swift Testing uses.

[heckj]

Using "currently" begs the question of how relevant is the content when the reader is finding it and when the doc was published; I'd recommend dropping it.

[grynspan]

"uses at the time of this writing" perhaps

[stmontgomery]

For these, I wonder if using a footnote for each one containing a link to a relevant website which documents it would be useful? I tried clicking the asterisk thinking it might reveal more information and thought that might be helpful

[stmontgomery]

I just landed #1287 and it added a new env var SWT_EXPERIMENTAL_EVENT_STREAM_FIELDS_ENABLED. Could we add that here before landing?

I imagine we could place it in a new section (with its own table) titled "Event stream" perhaps, and hoist SWT_PRETTY_PRINT_JSON there as well instead of having that be in the "Miscellaneous" section.