add license
4 files changed
tree: 40c0c96ce9c6584b63917afe8c3b6966a0383610
  1. .asf.yaml



This repo is a temporary solution to publishing the Apache Pekko website. The artifacts are built in the Pekko modules. A Pekko committer can use the commands below to copy these artifacts and commit them.

Anyone looking to help improve our docs should look at the Git repos (eg incubator-pekko) for the modules. Typically, sbt docs/paradoxBrowse will build the docs and load them into your browser when they are ready.


Publishing the Apache Pekko web site requires:

  1. Clone into a local directory.
  2. Check out the asf-staging branch.
  3. In incubator-pekko repo, run
sbt unidoc docs/paradox
# next line requires Java 11 or above
sbt -Dpekko.genjavadoc.enabled=true Javaunidoc/doc 
  1. Go back to your local copy of incubator-pekko-site and run
cp -r <path>/incubator-pekko/docs/target/paradox/site/main/ content/docs/pekko/current/
cp -r <path>/incubator-pekko/target/scala-2.13/unidoc/ content/api/pekko/current/
cp -r <path>/incubator-pekko/target/javaunidoc/ content/japi/pekko/current/
  1. Perform git add on the affected files and git commit.
  2. Perform git push.
  3. After a few minutes review and make sure the appropriate changes are present.
  4. Once the site has been approved checkout the asf-site branch.
  5. Perform git rebase asf-staging followed by git push.
  6. After a few minutes verify that 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.