Update documentation to discuss raw identifiers.

[grynspan]

We need to update our documentation, especially around @Suite and @Test, to discuss raw identifiers in place of the displayName argument. In particular, where we currently recommend something like:

@Test("foo bar baz") func f() { ... }

We probably want to offer this instead:

@Test func `foo bar baz`() { ... }