Releases Page Structure🔗

This directory contains the releases page for Apache Polaris releases.

Structure🔗

downloads/
├── _index.md           # Landing page with links to all versions
├── 1.3.0/
│   └── index.md       # Version 1.3.0 details
├── 1.2.0/
│   └── index.md       # Version 1.2.0 details
└── ...

Adding a New Release🔗

When adding a new release, follow these steps:

  1. Create a new version directory: Create [major].[minor].[patch]/index.md

    • Use an existing version page as a template (e.g., 1.3.0/index.md)
    • Update the title, linkTitle, release_version, and release date
    • Update weight: use a negative weight derived from the version, e.g. 1.2.3 -> -10203
    • Add the downloads table with links to artifacts
    • Include release notes

  2. Update the landing page (_index.md):

    • Add the new version to “Active Releases”

  3. Update the “latest” page (latest/index.md):

    • Update the redirect_to parameter to point to the new version

  4. Update site/hugo.yaml:

    • Add the new version to the active_releases list

  5. Update the previous release’s page:

    • Current release: use https://dlcdn.apache.org/ for source/binary artifacts and https://downloads.apache.org/ for signatures/checksums
    • Previous releases: use https://archive.apache.org/dist/ for all artifacts
    • Maven artifacts: always use https://repo1.maven.org/maven2/

The resulting version page should have a front matter matching the one below:

 1---
 2title: "Apache Polaris [version]"  # Full title shown on the page
 3linkTitle: "[version]"  # Short version shown in the sidebar
 4release_version: "[version]"  # Used for active/EOL categorization
 5release_date: [YYYY-MM-DD]. # Date of release in YYYY-MM-DD format
 6weight: [number]  # Negative weight derived from the version, e.g. 1.2.3 -> -10203
 7hide_summary: true
 8exclude_search: true
 9type: downloads
10menus:
11  main:
12    parent: releases
13    weight: [number]  # Same as page weight for consistency
14    identifier: releases-[version]  # Unique identifier, e.g.: releases-1.3.0, releases-1.2.0, etc.
15---

No manual configuration in site/hugo.yaml is needed.

The releases sidebar automatically categorizes releases into “Active Releases” and “EOL Releases” based on the active_releases list in site/hugo.yaml. The release_version front matter param is used to match against this list.

See Also🔗