jojochuang commented on code in PR #457: URL: https://github.com/apache/ozone-site/pull/457#discussion_r3384499857
########## docs/08-developer-guide/04-project/02-release-guide.md: ########## @@ -522,15 +522,19 @@ To publish the artifacts to [Maven Central](https://central.sonatype.com), login ### Write a Haiku -Check the tag from the [Ozone Roadmap](https://cwiki.apache.org/confluence/display/OZONE/Ozone+Roadmap) page (it's a national park). +Check the release's national park tag, set in the `<ozone.release>` property of the project's top level pom (also shown by `bin/ozone version`). Find a photo which is under the CC license. Write a haiku to the photo with Future font. ### Update the Ozone Website -1. Create release notes and add them to the Ozone website with your haiku image. An example pull request showing how to do this is [here](https://github.com/apache/ozone-site/pull/17). Note that the target branch is `master`. Please write the release notes in [Keep a Changelog](https://keepachangelog.com/en/1.1.0/) format. In particular, make sure it is human readable and not a simple commit log diffs. -2. Extract the docs folder from the release tarball, and add its contents to the website. An example pull request for this is [here](https://github.com/apache/ozone-site/pull/18). Note that the target branch is `asf-site` , and that the `docs/current` symlink has been updated to point to the latest release's directory. -3. Test the website locally by running `hugo serve` from the repository root with the master branch checked out. Check that links for the new release are working. Links to the documentation will not work until the PR to the `asf-site` branch is merged. +The website is rendered from the `master` branch of the [apache/ozone-site](https://github.com/apache/ozone-site) repository. Open a pull request against the `master` branch that: + +1. Updates the [Downloads page](https://ozone.apache.org/download/) (`src/pages/download.md`) to include the artifacts of the new release version. +2. Adds release notes for the new version under `src/pages/release-notes/` with your haiku image. Please write the release notes in [Keep a Changelog](https://keepachangelog.com/en/1.1.0/) format. In particular, make sure it is human readable and not a simple commit log diff. +3. Creates a versioned copy of the documentation for the release. See [this pull request](https://github.com/apache/ozone-site/pull/330) for an example. Review Comment: ```suggestion 3. Creates a versioned copy of the documentation for the release. See [this pull request](https://github.com/apache/ozone-site/pull/330) for an example, and check out the instructions from the [Docusaurus website](https://docusaurus.io/docs/versioning#tagging-a-new-version). ``` -- This is an automated message from the Apache Git Service. To respond to the message, please log on to GitHub and use the URL above to go to the specific comment. To unsubscribe, e-mail: [email protected] For queries about this service, please contact Infrastructure at: [email protected] --------------------------------------------------------------------- To unsubscribe, e-mail: [email protected] For additional commands, e-mail: [email protected]
