Skip to content

HDDS-14663. [Docs] Fix broken links #351

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Open
jojochuang wants to merge 4 commits into
base: master
Choose a base branch
from
Open

HDDS-14663. [Docs] Fix broken links #351

Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
4 commits
Select commit Hold shift + click to select a range
627b485
feat: Rename download page to downloads and update all references
jojochuang Feb 19, 2026
3121b38
feat: Rename release-notes directory to release and update all refere…
jojochuang Feb 19, 2026
1d2d2bc
chore: Clean up old release-notes files after directory rename
jojochuang Feb 19, 2026
88461e5
Fix
jojochuang Feb 19, 2026
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
The table of contents is too big for display.
Diff view
Diff view
  •  
  •  
  •  
2 changes: 1 addition & 1 deletion blog/2026-01-30-apache-ozone-best-practices-at-didi.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -5,7 +5,7 @@ authors: ["rich7420", "apache-ozone-community", "slfan1989", "whbing", "jianghua
tags: [user-stories, performance, erasure-coding, scale]
---

Guest post by the Didi Engineering Team. For the full story with detailed slides, see [Apache Ozone Best Practices at Didi (PDF)](https://ozone.apache.org/assets/ApacheOzoneBestPracticesAtDidi.pdf).
Guest post by the Didi Engineering Team. For the full story with detailed slides, see [Apache Ozone Best Practices at Didi (PDF)](/ApacheOzoneBestPracticesAtDidi.pdf).

As Didi's volume of unstructured data surged into the hundreds of petabytes, comprising tens of billions of files, their traditional storage architecture faced severe scalability bottlenecks. This post summarizes how they migrated from HDFS to Apache Ozone, the optimizations they implemented for high-performance reads, and their journey in contributing these improvements back to the community.

Expand Down
2 changes: 1 addition & 1 deletion docs/05-administrator-guide/01-installation/04-installing-binaries.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -11,7 +11,7 @@ First, identify the hosts where Ozone will be installed. The installation steps
To obtain the Ozone binaries, you have two primary options:

1. **Official Apache Ozone Releases**:
For official releases, navigate to the [Downloads page](/download) to get the released binary tarball. Follow the instructions to verify the integrity of the tarball.
For official releases, navigate to the [Downloads page](/downloads) to get the released binary tarball. Follow the instructions to verify the integrity of the tarball.

2. **Build from Source**:
Alternatively, you can build Ozone from its source code. Follow the detailed instructions in the [Developer Guide: Building Ozone With Maven](../../developer-guide/build/maven).
Expand Down
2 changes: 1 addition & 1 deletion docs/08-developer-guide/01-build/01-maven.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -33,7 +33,7 @@ Choose one of the following methods to get the source code:
```
</TabItem>
<TabItem value="Tarball" label="Tarball">
Use this option if you only want a released version of Ozone. Source code for Ozone releases can be obtained from the [download page](/download).
Use this option if you only want a released version of Ozone. Source code for Ozone releases can be obtained from the [download page](/downloads).
```bash
tar xzf ozone-<version>-src.tar.gz
cd ozone-<version>-src
Expand Down
2 changes: 1 addition & 1 deletion docusaurus.config.js
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -344,7 +344,7 @@ const config = {
],
},
{
to: 'download',
to: 'downloads',
Copy link
Copy Markdown

@chihsuan chihsuan Apr 29, 2026

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

This renaming creates new broken external links for anything that's bookmarked or indexed, pointing to the old paths.

/release-notes/* renaming will also likely 404 after the rename. Was a redirect considered (e.g. via @docusaurus/plugin-client-redirects)?

label: 'Download',
},
{
Expand Down
6 changes: 3 additions & 3 deletions src/pages/download.md → src/pages/downloads.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -2,9 +2,9 @@

| Version | Release Date | Source Download | Binary Download | Release Notes |
| ------- | ------------ | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ------------------------------------- |
| 2.1.0 | 2025 Dec 31 | [Source](https://www.apache.org/dyn/closer.cgi/ozone/2.1.0/ozone-2.1.0-src.tar.gz)<br/>[Checksum](https://downloads.apache.org/ozone/2.1.0/ozone-2.1.0-src.tar.gz.sha512)<br/>[Signature](https://downloads.apache.org/ozone/2.1.0/ozone-2.1.0-src.tar.gz.asc) | [Binary](https://www.apache.org/dyn/closer.cgi/ozone/2.1.0/ozone-2.1.0.tar.gz)<br/>[Checksum](https://downloads.apache.org/ozone/2.1.0/ozone-2.1.0.tar.gz.sha512)<br/>[Signature](https://downloads.apache.org/ozone/2.1.0/ozone-2.1.0.tar.gz.asc) | [Release Notes](/release-notes/2.1.0) |
| 2.0.0 | 2025 Apr 30 | [Source](https://www.apache.org/dyn/closer.cgi/ozone/2.0.0/ozone-2.0.0-src.tar.gz)<br/>[Checksum](https://downloads.apache.org/ozone/2.0.0/ozone-2.0.0-src.tar.gz.sha512)<br/>[Signature](https://downloads.apache.org/ozone/2.0.0/ozone-2.0.0-src.tar.gz.asc) | [Binary](https://www.apache.org/dyn/closer.cgi/ozone/2.0.0/ozone-2.0.0.tar.gz)<br/>[Checksum](https://downloads.apache.org/ozone/2.0.0/ozone-2.0.0.tar.gz.sha512)<br/>[Signature](https://downloads.apache.org/ozone/2.0.0/ozone-2.0.0.tar.gz.asc) | [Release Notes](/release-notes/2.0.0) |
| 1.4.1 | 2024 Nov 24 | [Source](https://www.apache.org/dyn/closer.cgi/ozone/1.4.1/ozone-1.4.1-src.tar.gz)<br/>[Checksum](https://downloads.apache.org/ozone/1.4.1/ozone-1.4.1-src.tar.gz.sha512)<br/>[Signature](https://downloads.apache.org/ozone/1.4.1/ozone-1.4.1-src.tar.gz.asc) | [Binary](https://www.apache.org/dyn/closer.cgi/ozone/1.4.1/ozone-1.4.1.tar.gz)<br/>[Checksum](https://downloads.apache.org/ozone/1.4.1/ozone-1.4.1.tar.gz.sha512)<br/>[Signature](https://downloads.apache.org/ozone/1.4.1/ozone-1.4.1.tar.gz.asc) | [Release Notes](/release-notes/1.4.1) |
| 2.1.0 | 2025 Dec 31 | [Source](https://www.apache.org/dyn/closer.cgi/ozone/2.1.0/ozone-2.1.0-src.tar.gz)<br/>[Checksum](https://downloads.apache.org/ozone/2.1.0/ozone-2.1.0-src.tar.gz.sha512)<br/>[Signature](https://downloads.apache.org/ozone/2.1.0/ozone-2.1.0-src.tar.gz.asc) | [Binary](https://www.apache.org/dyn/closer.cgi/ozone/2.1.0/ozone-2.1.0.tar.gz)<br/>[Checksum](https://downloads.apache.org/ozone/2.1.0/ozone-2.1.0.tar.gz.sha512)<br/>[Signature](https://downloads.apache.org/ozone/2.1.0/ozone-2.1.0.tar.gz.asc) | [Release Notes](/release/2.1.0) |
| 2.0.0 | 2025 Apr 30 | [Source](https://www.apache.org/dyn/closer.cgi/ozone/2.0.0/ozone-2.0.0-src.tar.gz)<br/>[Checksum](https://downloads.apache.org/ozone/2.0.0/ozone-2.0.0-src.tar.gz.sha512)<br/>[Signature](https://downloads.apache.org/ozone/2.0.0/ozone-2.0.0-src.tar.gz.asc) | [Binary](https://www.apache.org/dyn/closer.cgi/ozone/2.0.0/ozone-2.0.0.tar.gz)<br/>[Checksum](https://downloads.apache.org/ozone/2.0.0/ozone-2.0.0.tar.gz.sha512)<br/>[Signature](https://downloads.apache.org/ozone/2.0.0/ozone-2.0.0.tar.gz.asc) | [Release Notes](/release/2.0.0) |
| 1.4.1 | 2024 Nov 24 | [Source](https://www.apache.org/dyn/closer.cgi/ozone/1.4.1/ozone-1.4.1-src.tar.gz)<br/>[Checksum](https://downloads.apache.org/ozone/1.4.1/ozone-1.4.1-src.tar.gz.sha512)<br/>[Signature](https://downloads.apache.org/ozone/1.4.1/ozone-1.4.1-src.tar.gz.asc) | [Binary](https://www.apache.org/dyn/closer.cgi/ozone/1.4.1/ozone-1.4.1.tar.gz)<br/>[Checksum](https://downloads.apache.org/ozone/1.4.1/ozone-1.4.1.tar.gz.sha512)<br/>[Signature](https://downloads.apache.org/ozone/1.4.1/ozone-1.4.1.tar.gz.asc) | [Release Notes](/release/1.4.1) |

## Archives

Expand Down
0 src/pages/release-notes/1.4.1.md → src/pages/release/1.4.1.md
View file
Open in desktop
File renamed without changes.
0 src/pages/release-notes/2.0.0.md → src/pages/release/2.0.0.md
View file
Open in desktop
File renamed without changes.
0 src/pages/release-notes/2.1.0.md → src/pages/release/2.1.0.md
View file
Open in desktop
File renamed without changes.
6 changes: 6 additions & 0 deletions src/pages/release/index.md
View file
Open in desktop
Original file line number Diff line number Diff line change
@@ -0,0 +1,6 @@
---
title: Release Notes
sidebar_label: Release Notes
---

This page contains the release notes for Apache Ozone. Please navigate to the specific version to view its release notes.
Copy link
Copy Markdown

@chihsuan chihsuan Apr 29, 2026

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

I've noticed that when visiting this page, we aren't able to navigate directly to a specific version. Was this an intentional design choice?

Perhaps we should add a version list (for example: - Apache Ozone 2.1.0 — 2025-12-31...). Alternatively, linking prominently to the /downloads page might be helpful. Since the Downloads table already lists each version with its corresponding release notes link, this page wouldn't need to repeat that information or require updates with each new release. Just share a few thoughts.

Image

Binary file added static/ApacheOzoneBestPracticesAtDidi.pdf
View file
Open in desktop
Binary file not shown.
20 changes: 20 additions & 0 deletions static/docs/edge/NOTES.md
View file
Open in desktop
Original file line number Diff line number Diff line change
@@ -0,0 +1,20 @@
<!---
Licensed to the Apache Software Foundation (ASF) under one or more
contributor license agreements. See the NOTICE file distributed with
this work for additional information regarding copyright ownership.
The ASF licenses this file to You under the Apache License, Version 2.0
(the "License"); you may not use this file except in compliance with
the License. You may obtain a copy of the License at

http://www.apache.org/licenses/LICENSE-2.0

Unless required by applicable law or agreed to in writing, software
distributed under the License is distributed on an "AS IS" BASIS,
WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
See the License for the specific language governing permissions and
limitations under the License.
-->

The source of Ozone logo is available here:

https://gitbox.apache.org/repos/asf?p=hadoop-site.git;a=tree;f=ozone/static;hb=refs/heads/asf-site
Binary file added static/docs/edge/OzoneOverview.png
View file
Open in desktop
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Loading
Loading