The https://pekko.apache.org web site is mainly based on .htaccess redirects to https://nightlies.apache.org/pekko/docs/. The files on the nightlies site are rsynced using nightly publish jobs in the various Pekko GitHub repos (GitHub Actions).

This pekko-site repo has content to act as the home page for these application docs.

Publishing the Apache Pekko web site requires:

• Clone https://github.com/apache/pekko-site into a local directory.
• Check out the main branch.

Open command window and change to pekko-site directory.

If you have made big changes and want to clean out the old copy of the published files.

rm -rf content
mkdir content

To publish latest docs, use Java 17 or a recent Java release (Java 8 no longer works):

sbt clean paradox
cp -r target/paradox/site/main/. content/

The . means that hidden files like .htaccess will be copied.

• Perform git add on the affected files and git commit.
• Perform git push.
• We usually start by publishing to https://pekko.staged.apache.org.
• Perform git rebase main followed by git push.
• After a few minutes review https://pekko.staged.apache.org and make sure the appropriate changes are present.
• Once the site has been approved checkout the asf-site branch.
• Perform git rebase asf-staging followed by git push.
• After a few minutes verify that https://pekko.apache.org has the correct changes.

This approach is based on the support for publishing sites provided by INFRA team. See .asf.yaml features documentation.

This approach is based on the Apache Flume process, see How to Release - Update the Web Site.