[nomaster] SI-8787 Backport Regex doc

Backport the doc with two material changes: need to use Groups
to extract from Match, and relatedly, there is no secondary
constructor, so that doc is moved up.