SI-7544 StringContext.f docs update

Correct the scaladoc to reflect how f"%" is handled,
namely, it's no longer taken as f"%%".

Stole this correction from https://github.com/scala/scala/pull/3360. Except for the `%q` part.