Versioning

You can allow readers to view different versions of a catalog on the documentation portal. To do this, specify in the catalog settings which versions will be available on the portal. A version can be represented by either a branch or a tag.

  • Current Version: The active branch, set by the editor, is considered the current version. It will always appear as the first item in the list.

  • Glob Patterns: Use glob patterns to select the desired versions.

Examples of Glob Patterns

  1. Matching Branches and Tags:
    Specifying the pattern releases/**/* will display all branches and tags whose names start with releases.

  2. Targeting Tags Only:
    Use refs/tags or tags to include only tags.

  3. Targeting Branches Only:
    Use refs/heads or heads to include only branches.
    For example, the pattern heads/releases/v1.* will display all release branches with a major version of 1 to readers.