Google Git
Sign in
apache/rai-site

Apache Responsible AI Website

Mirrored from https://github.com/apache/rai-site.git
Clone this repo:

Branches

  1. 96ff4d7 Update README with note on running make check by Andrew Musselman · 21 hours ago main
  2. 83366e6 Fix pelican by Jeff Genender · 25 hours ago
  3. 7ee97c1 Fix citations for US copyright (#9) by Jeff Genender · 26 hours ago
  4. 549bab8 Rewording quote lead-in on about by Andrew Musselman · 28 hours ago
  5. aea8ece Facelift redux (#8) by Andrew Musselman · 28 hours ago

Apache Responsible AI — website (rai-site)

Source for the Apache Responsible AI initiative website.

The site is a static Pelican site, built by the ASF infrastructure from this repository via .asf.yaml (the pelican: block builds main and publishes the generated HTML to the asf-site branch, which is served at rai.apache.org). Content is written in Markdown with Mermaid diagram support.

Layout

content/
  pages/        Markdown pages (one file per page)
  theme/        Pelican theme (templates)
  css/ js/ fonts/ highlight/ images/   static assets
pelicanconf.py  Pelican configuration (Python)
pelicanconf.yaml
.asf.yaml       ASF infrastructure configuration (build + notifications)
pyproject.toml  Python dependencies (managed with uv)

Editing content

  • Pages live in content/pages/*.md. Each page starts with a short metadata block (Title: and license:); the home page also sets Template: index.
  • New pages appear automatically; add them to the navigation in content/theme/templates/menu.html.
  • Changes go through a pull request (fork, branch, PR) - for small fixes, GitHub's pencil icon on a file is a quick way to start one straight from the file view.
  • Note when making any substantive changes run make check before committing. This will surface any potential CI/CD failures in your PR.

Local build (optional)

The authoritative build runs on ASF infrastructure. To preview locally you need the ASF Pelican plugins (asfgenid, asfrun, gfm, …) provided by apache/infrastructure-pelican; see that project for setup.

Previewing proposed changes

Any branch in this repository that is named preview/* will auto-build and stage to rai-*.staged.apache.org.

If you need to test your changes, create a branch such as preview/<your-asf-id>.

Commits to it will be staged at rai-<your-asf-id>.staged.apache.org.

[!NOTE]

The branch name must not include any “.” characters, or browsers will refuse to display the site due to an invalid SSL certificate. The underscore character (“_”) should not be used either, as it is disallowed in host names.

Get involved

License

This project is licensed under Apache License, Version 2.0.