adutra opened a new pull request, #3935:
URL: https://github.com/apache/polaris/pull/3935
This PR redesigns the website's Releases and Documentation sections to
improve navigation and maintainability.
Benefits:
- **Better UX**: Easier navigation with dropdown menus and dedicated pages
per release
- **Maintainability**: Adding new releases requires fewer manual updates
- **Consistency**: Automated listing ensures all releases are displayed
uniformly
## Key Changes
### 1. Split Releases into Individual Pages
- Converted the single-page `/downloads/_index.md` into individual release
pages under `/downloads/{version}/index.md`
- Each release now has its own dedicated page with downloads, release notes,
and metadata
- Added pages for all releases: 0.9.0, 1.0.0, 1.0.1, 1.1.0, 1.2.0, and 1.3.0
### 2. New Releases Dropdown Menu
- Added a dropdown menu in the navbar for the Releases section
- Active releases appear in the dropdown; EOL releases are excluded from the
menu but remain accessible (note: there are no EOL releases atm!).
### 3. Latest Release Permalink
- Introduced a new permalink for the latest release:
`https://polaris.apache.org/downloads/latest/`
- This provides a stable URL that always points to the most recent release
### 4. Automated Landing Pages
- Redesigned both Documentation (`/docs/_index.md`) and Releases
(`/downloads/_index.md`) landing pages
- These pages now automatically display available versions using new
shortcodes
- No manual updates needed when adding new releases
### 5. Simplified Configuration
- Removed manual menu entries for individual releases from `hugo.yaml`
- Releases now register themselves via front matter `menus` configuration
- Only `active_releases` list needs updating in `hugo.yaml`
### 6. Updated Release Guides
- Updated both manual and semi-automated release guides with new instructions
<!--
๐ Describe what changes you're proposing, especially breaking or user-facing
changes.
๐ See https://github.com/apache/polaris/blob/main/CONTRIBUTING.md for more.
-->
## Checklist
- [ ] ๐ก๏ธ Don't disclose security issues! (contact [email protected])
- [ ] ๐ Clearly explained why the changes are needed, or linked related
issues: Fixes #
- [ ] ๐งช Added/updated tests with good coverage, or manually tested (and
explained how)
- [ ] ๐ก Added comments for complex logic
- [ ] ๐งพ Updated `CHANGELOG.md` (if needed)
- [ ] ๐ Updated documentation in `site/content/in-dev/unreleased` (if needed)
--
This is an automated message from the Apache Git Service.
To respond to the message, please log on to GitHub and use the
URL above to go to the specific comment.
To unsubscribe, e-mail: [email protected]
For queries about this service, please contact Infrastructure at:
[email protected]
