In Jira smart values, the match method needs more detailing.

• It's not clear that the pattern we really want is the one between parenthesis
  Maybe that's what it means when it's said it returns the first regex group, which is delimited by the parenthesis.
  One would need to go into the Java documentation to understand that, so I think we need to explain this better here.
• The example is confusing. A simple line break would make it much more readable

  {{issue.summary.match(".*(lo).*")}} -> lo
  {{issue.summary.match(".*(o).*")}} -> [o, o]
  

• It's not clear if there's a way to choose between the first match only or a potential collection of matches.
  My understanding is that it depends on the data - it returns one simple string if it's just one match, or a collection if it's multiple matches.
• An example on how to deal with multiple matches would be a nice bonus. Even just linking Examples of using smart values with lists would help our customers already