You are viewing a plain text version of this content. The canonical link for it is here.
Posted to commits@burr.apache.org by eb...@apache.org on 2026/05/10 04:36:35 UTC
(burr) 01/01: website: add Downloads page per ASF release policy
This is an automated email from the ASF dual-hosted git repository.
elijahbenizzy pushed a commit to branch website/downloads-page
in repository https://gitbox.apache.org/repos/asf/burr.git
commit 7f24c35762aa4a58ae561c0cafb0a46a9459043e
Author: Elijah Ben Izzy <el...@users.noreply.github.com>
AuthorDate: Sat May 9 21:36:12 2026 -0700
website: add Downloads page per ASF release policy
Adds a /downloads route covering the 0.42.0-incubating and 0.41.0-incubating
releases with mirror-selection links for tarballs, direct HTTPS links for
signatures and checksums, GPG/SHA-512 verification instructions, and the
standard incubator disclaimer. Adds a "Download" entry to the navbar.
Addresses the IPMC vote feedback that burr.apache.org needs a public
download page per https://www.apache.org/legal/release-policy.html#publication.
The repo-root .gitignore has a `downloads/` rule (Python packaging), which
shadows the new Next.js app-router directory; a negation rule is added in
website/.gitignore to re-include it.
---
website/.gitignore | 4 +
website/src/app/downloads/page.tsx | 416 +++++++++++++++++++++++++++++++++++++
website/src/lib/constants.ts | 7 +-
3 files changed, 424 insertions(+), 3 deletions(-)
diff --git a/website/.gitignore b/website/.gitignore
index a047376c..ae5e03fe 100644
--- a/website/.gitignore
+++ b/website/.gitignore
@@ -4,3 +4,7 @@ out/
*.tsbuildinfo
next-env.d.ts
public/docs/
+
+# The repo-root .gitignore has `downloads/` (Python packaging convention),
+# which would otherwise hide the Next.js /downloads app route. Re-include it.
+!src/app/downloads/
diff --git a/website/src/app/downloads/page.tsx b/website/src/app/downloads/page.tsx
new file mode 100644
index 00000000..94c25009
--- /dev/null
+++ b/website/src/app/downloads/page.tsx
@@ -0,0 +1,416 @@
+/*
+ * 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.
+ */
+
+import type { Metadata } from "next";
+import Navbar from "@/components/Navbar";
+import Footer from "@/components/Footer";
+
+export const metadata: Metadata = {
+ title: "Downloads — Apache Burr (Incubating)",
+ description:
+ "Download Apache Burr (Incubating) source releases, signatures, and checksums. Includes verification instructions per ASF release policy.",
+};
+
+// Apache mirror selection URL prefix (closer.lua) for tarball downloads.
+// Per ASF release policy, signatures (.asc), checksums (.sha512), and the
+// KEYS file MUST be served directly over HTTPS from downloads.apache.org
+// rather than via mirrors.
+const MIRROR_BASE = "https://www.apache.org/dyn/closer.lua/incubator/burr";
+const DIST_BASE = "https://downloads.apache.org/incubator/burr";
+const KEYS_URL = `${DIST_BASE}/KEYS`;
+const ARCHIVE_URL = "https://archive.apache.org/dist/incubator/burr/";
+const VERIFY_DOC_URL = "https://www.apache.org/info/verification.html";
+const RELEASE_POLICY_URL =
+ "https://www.apache.org/legal/release-policy.html#publication";
+
+type Artifact = {
+ filename: string;
+ label: string;
+ description: string;
+};
+
+type Release = {
+ version: string; // e.g. "0.42.0"
+ date: string; // human-readable
+ artifacts: Artifact[];
+};
+
+const RELEASES: Release[] = [
+ {
+ version: "0.42.0",
+ date: "May 9, 2026",
+ artifacts: [
+ {
+ filename: "apache-burr-0.42.0-incubating-src.tar.gz",
+ label: "Source release",
+ description:
+ "The official source release. This is the artifact voted on by the IPMC.",
+ },
+ {
+ filename: "apache-burr-0.42.0-incubating-sdist.tar.gz",
+ label: "Python sdist",
+ description:
+ "Python source distribution used by flit to build the wheel. Convenience artifact.",
+ },
+ {
+ filename: "apache_burr-0.42.0-py3-none-any.whl",
+ label: "Python wheel",
+ description:
+ "Pre-built Python wheel. Convenience binary, also published on PyPI as apache-burr 0.42.0.",
+ },
+ ],
+ },
+ {
+ version: "0.41.0",
+ date: "January 2026",
+ artifacts: [
+ {
+ filename: "apache-burr-0.41.0-incubating-src.tar.gz",
+ label: "Source release",
+ description: "The official source release.",
+ },
+ {
+ filename: "apache-burr-0.41.0-incubating-sdist.tar.gz",
+ label: "Python sdist",
+ description: "Python source distribution used by flit to build the wheel.",
+ },
+ {
+ filename: "apache_burr-0.41.0-py3-none-any.whl",
+ label: "Python wheel",
+ description:
+ "Pre-built Python wheel. Convenience binary, also published on PyPI as apache-burr 0.41.0.",
+ },
+ ],
+ },
+];
+
+const LATEST = RELEASES[0];
+
+function mirrorUrl(version: string, filename: string): string {
+ return `${MIRROR_BASE}/${version}/${filename}?action=download`;
+}
+
+function directUrl(version: string, filename: string, ext: string): string {
+ return `${DIST_BASE}/${version}/${filename}.${ext}`;
+}
+
+function ReleaseSection({
+ release,
+ isLatest,
+}: {
+ release: Release;
+ isLatest: boolean;
+}) {
+ const headingId = `release-${release.version}`;
+ return (
+ <section
+ id={headingId}
+ className="rounded-2xl border border-[var(--card-border)] bg-[var(--card-bg)] p-6 sm:p-8"
+ >
+ <div className="flex flex-wrap items-baseline gap-x-3 gap-y-1 mb-1">
+ <h2 className="text-2xl font-bold">
+ {release.version}-incubating
+ </h2>
+ {isLatest && (
+ <span className="inline-flex items-center rounded-full border border-[#7B2FBE]/30 bg-[#7B2FBE]/10 px-2.5 py-0.5 text-xs font-semibold text-[#7B2FBE]">
+ Latest
+ </span>
+ )}
+ <span className="text-sm text-[var(--muted)]">
+ Released {release.date}
+ </span>
+ </div>
+
+ <div className="mt-6 overflow-x-auto">
+ <table className="w-full text-sm">
+ <thead>
+ <tr className="text-left border-b border-[var(--card-border)] text-[var(--muted)]">
+ <th className="py-2 pr-4 font-medium">Artifact</th>
+ <th className="py-2 pr-4 font-medium">Download</th>
+ <th className="py-2 pr-4 font-medium">Signature</th>
+ <th className="py-2 font-medium">Checksum</th>
+ </tr>
+ </thead>
+ <tbody>
+ {release.artifacts.map((a) => (
+ <tr
+ key={a.filename}
+ className="border-b border-[var(--card-border)]/50 last:border-b-0 align-top"
+ >
+ <td className="py-3 pr-4">
+ <div className="font-medium">{a.label}</div>
+ <div className="text-xs text-[var(--muted)] mt-0.5">
+ {a.description}
+ </div>
+ </td>
+ <td className="py-3 pr-4">
+ <a
+ href={mirrorUrl(release.version, a.filename)}
+ className="text-[#7B2FBE] hover:underline break-all font-mono text-xs"
+ >
+ {a.filename}
+ </a>
+ </td>
+ <td className="py-3 pr-4">
+ <a
+ href={directUrl(release.version, a.filename, "asc")}
+ className="text-[var(--muted)] hover:text-[var(--text)] hover:underline font-mono text-xs"
+ >
+ .asc
+ </a>
+ </td>
+ <td className="py-3">
+ <a
+ href={directUrl(release.version, a.filename, "sha512")}
+ className="text-[var(--muted)] hover:text-[var(--text)] hover:underline font-mono text-xs"
+ >
+ .sha512
+ </a>
+ </td>
+ </tr>
+ ))}
+ </tbody>
+ </table>
+ </div>
+
+ <p className="mt-4 text-xs text-[var(--muted)]">
+ Tarball links use the{" "}
+ <a
+ href="https://www.apache.org/dyn/closer.cgi"
+ target="_blank"
+ rel="noopener noreferrer"
+ className="underline hover:text-[var(--text)]"
+ >
+ ASF mirror selection service
+ </a>{" "}
+ to find the closest mirror. Signatures and checksums are served directly
+ from <code className="font-mono">downloads.apache.org</code> over HTTPS.
+ </p>
+ </section>
+ );
+}
+
+export default function DownloadsPage() {
+ return (
+ <>
+ <Navbar />
+ <main className="py-16 sm:py-20">
+ <div className="mx-auto max-w-4xl px-4 sm:px-6 lg:px-8">
+ {/* Header */}
+ <header className="mb-12">
+ <h1 className="text-4xl font-extrabold tracking-tight sm:text-5xl">
+ Downloads
+ </h1>
+ <p className="mt-3 text-lg text-[var(--muted)]">
+ Apache Burr (Incubating) — official source releases, signatures,
+ and checksums.
+ </p>
+ <p className="mt-4 text-sm text-[var(--muted)]">
+ Apache Burr is currently undergoing incubation at the Apache
+ Software Foundation. The source release is the official artifact;
+ binary downloads are provided for convenience. Please see the{" "}
+ <a
+ href={RELEASE_POLICY_URL}
+ target="_blank"
+ rel="noopener noreferrer"
+ className="underline hover:text-[var(--text)]"
+ >
+ ASF release policy
+ </a>{" "}
+ and the{" "}
+ <a
+ href="#disclaimer"
+ className="underline hover:text-[var(--text)]"
+ >
+ incubator disclaimer
+ </a>{" "}
+ below.
+ </p>
+ </header>
+
+ {/* Quick install */}
+ <section className="mb-12 rounded-2xl border border-[var(--card-border)] bg-[var(--card-bg)] p-6 sm:p-8">
+ <h2 className="text-2xl font-bold mb-3">Quick install</h2>
+ <p className="text-sm text-[var(--muted)] mb-4">
+ The fastest way to get started is via PyPI. The convenience wheel
+ published there matches the wheel artifact in the source release.
+ </p>
+ <pre className="overflow-x-auto rounded-lg border border-[var(--card-border)] bg-[var(--bg)] p-4 text-sm font-mono">
+ <code>{`pip install apache-burr==${LATEST.version}`}</code>
+ </pre>
+ <p className="mt-4 text-xs text-[var(--muted)]">
+ For projects that require building from source, download the
+ source release tarball below and verify it before use.
+ </p>
+ </section>
+
+ {/* Latest release */}
+ <div className="mb-12">
+ <h2 className="text-xl font-semibold mb-4 text-[var(--muted)] uppercase tracking-wide text-sm">
+ Latest release
+ </h2>
+ <ReleaseSection release={LATEST} isLatest />
+ </div>
+
+ {/* Previous releases */}
+ {RELEASES.length > 1 && (
+ <div className="mb-12">
+ <h2 className="text-xl font-semibold mb-4 text-[var(--muted)] uppercase tracking-wide text-sm">
+ Previous releases
+ </h2>
+ <div className="space-y-6">
+ {RELEASES.slice(1).map((r) => (
+ <ReleaseSection
+ key={r.version}
+ release={r}
+ isLatest={false}
+ />
+ ))}
+ </div>
+ <p className="mt-4 text-xs text-[var(--muted)]">
+ Older releases are kept in the{" "}
+ <a
+ href={ARCHIVE_URL}
+ target="_blank"
+ rel="noopener noreferrer"
+ className="underline hover:text-[var(--text)]"
+ >
+ ASF archive
+ </a>
+ .
+ </p>
+ </div>
+ )}
+
+ {/* Verifying releases */}
+ <section
+ id="verify"
+ className="mb-12 rounded-2xl border border-[var(--card-border)] bg-[var(--card-bg)] p-6 sm:p-8"
+ >
+ <h2 className="text-2xl font-bold mb-3">Verifying releases</h2>
+ <p className="text-sm text-[var(--muted)]">
+ You <strong className="text-[var(--text)]">should</strong> verify
+ the integrity of any downloaded release before using it. The PGP
+ signature (
+ <code className="font-mono text-xs">.asc</code>) proves the
+ release was signed by an Apache Burr release manager; the SHA-512
+ checksum (
+ <code className="font-mono text-xs">.sha512</code>) detects
+ transmission corruption.
+ </p>
+
+ <h3 className="mt-6 mb-2 font-semibold">1. Download the KEYS file</h3>
+ <p className="text-sm text-[var(--muted)] mb-3">
+ The KEYS file contains the public PGP keys of all Apache Burr
+ release managers. It is served directly from{" "}
+ <code className="font-mono text-xs">downloads.apache.org</code>{" "}
+ over HTTPS:
+ </p>
+ <p className="text-sm">
+ <a
+ href={KEYS_URL}
+ className="text-[#7B2FBE] hover:underline font-mono text-xs break-all"
+ >
+ {KEYS_URL}
+ </a>
+ </p>
+ <pre className="mt-3 overflow-x-auto rounded-lg border border-[var(--card-border)] bg-[var(--bg)] p-4 text-sm font-mono">
+ <code>{`curl -O ${KEYS_URL}
+gpg --import KEYS`}</code>
+ </pre>
+
+ <h3 className="mt-6 mb-2 font-semibold">2. Verify the signature</h3>
+ <p className="text-sm text-[var(--muted)] mb-3">
+ Download the artifact and its{" "}
+ <code className="font-mono text-xs">.asc</code> signature, then:
+ </p>
+ <pre className="overflow-x-auto rounded-lg border border-[var(--card-border)] bg-[var(--bg)] p-4 text-sm font-mono">
+ <code>{`gpg --verify apache-burr-${LATEST.version}-incubating-src.tar.gz.asc \\
+ apache-burr-${LATEST.version}-incubating-src.tar.gz`}</code>
+ </pre>
+ <p className="mt-3 text-sm text-[var(--muted)]">
+ Look for "Good signature from ..." in the output. A
+ warning about the key not being certified by a trusted signature
+ is expected unless you have set up your trust web; what matters is
+ the key fingerprint matches one in KEYS.
+ </p>
+
+ <h3 className="mt-6 mb-2 font-semibold">3. Verify the checksum</h3>
+ <pre className="overflow-x-auto rounded-lg border border-[var(--card-border)] bg-[var(--bg)] p-4 text-sm font-mono">
+ <code>{`sha512sum -c apache-burr-${LATEST.version}-incubating-src.tar.gz.sha512`}</code>
+ </pre>
+ <p className="mt-3 text-sm text-[var(--muted)]">
+ On macOS, use{" "}
+ <code className="font-mono text-xs">shasum -a 512 -c</code>{" "}
+ instead of <code className="font-mono text-xs">sha512sum -c</code>
+ .
+ </p>
+
+ <p className="mt-6 text-sm text-[var(--muted)]">
+ For more detail on verifying ASF releases, see the{" "}
+ <a
+ href={VERIFY_DOC_URL}
+ target="_blank"
+ rel="noopener noreferrer"
+ className="underline hover:text-[var(--text)]"
+ >
+ official ASF verification guide
+ </a>
+ .
+ </p>
+ </section>
+
+ {/* License & disclaimer */}
+ <section
+ id="disclaimer"
+ className="rounded-2xl border border-[var(--card-border)] bg-[var(--card-bg)] p-6 sm:p-8"
+ >
+ <h2 className="text-2xl font-bold mb-3">License & disclaimer</h2>
+ <p className="text-sm text-[var(--muted)]">
+ Apache Burr is released under the{" "}
+ <a
+ href="https://www.apache.org/licenses/LICENSE-2.0"
+ target="_blank"
+ rel="noopener noreferrer"
+ className="underline hover:text-[var(--text)]"
+ >
+ Apache License, Version 2.0
+ </a>
+ . The full <code className="font-mono text-xs">LICENSE</code> and{" "}
+ <code className="font-mono text-xs">NOTICE</code> files are
+ included in every source release tarball.
+ </p>
+ <p className="mt-4 text-sm text-[var(--muted)]">
+ Apache Burr (Incubating) is an effort undergoing incubation at The
+ Apache Software Foundation (ASF), sponsored by the Apache
+ Incubator. Incubation is required of all newly accepted projects
+ until a further review indicates that the infrastructure,
+ communications, and decision making process have stabilized in a
+ manner consistent with other successful ASF projects. While
+ incubation status is not necessarily a reflection of the
+ completeness or stability of the code, it does indicate that the
+ project has yet to be fully endorsed by the ASF.
+ </p>
+ </section>
+ </div>
+ </main>
+ <Footer />
+ </>
+ );
+}
diff --git a/website/src/lib/constants.ts b/website/src/lib/constants.ts
index 30964ac5..1146e9d7 100644
--- a/website/src/lib/constants.ts
+++ b/website/src/lib/constants.ts
@@ -25,9 +25,10 @@ export const DISCORD_URL = "https://discord.gg/6Zy2DwP4f3";
export const TWITTER_URL = "https://x.com/burr_framework";
export const NAV_LINKS = [
- { label: "Features", href: "#features" },
- { label: "Integrations", href: "#integrations" },
- { label: "Community", href: "#community" },
+ { label: "Features", href: "/#features" },
+ { label: "Integrations", href: "/#integrations" },
+ { label: "Community", href: "/#community" },
+ { label: "Download", href: "/downloads" },
{ label: "Docs", href: DOCS_URL, external: true },
];