Make FilePatternMatcher.with_repr private and update docs

[kramstrom]

Describe your changes

• The current docs unfortunately show with_repr as the first method which should be private and is not useful for users. - Moved the documentation from the __call__ method to the class directly as it doesn't show up in the docs and isn't used directly.
• Added a from_file example

• Provide Linear issue reference (e.g. MOD-1234) if available.

Backward/forward compatibility checks

---

Check these boxes or delete any item (or this section) if not relevant for this PR.

• Client+Server: this change is compatible with old servers
• Client forward compatibility: this change ensures client can accept data intended for later versions of itself

Note on protobuf: protobuf message changes in one place may have impact to
multiple entities (client, server, worker, database). See points above.

---

Changelog

[freider]

thanks for fixing!