lukaszlenart opened a new pull request, #325: URL: https://github.com/apache/struts-site/pull/325
Follow-up to #324, and a prerequisite for retiring the cwiki release pages. ### Why #324 left the guidelines saying *what* a release manager needs access to — a signing key, ASF credentials for svn and Nexus — without saying how any of it is configured. That left the cwiki page [One time steps](https://cwiki.apache.org/confluence/pages/viewpage.action?pageId=27832952) as the only place describing the `KEYS` file and `~/.m2/settings.xml`, and `release:perform` does not work without them. Stubbing that page before porting this would have deleted a working instruction and put nothing in its place. ### What's ported A `Setting up for your first release` section under *Before you start*, covering the signing key and `KEYS`, the Maven settings, and `MAVEN_OPTS`. Modernised rather than copied: - **`KEYS` moved.** It lives in `dist/release/struts` now; the old page appends to a copy in `svn.apache.org/repos/asf/struts/maven/trunk/build` and `scp`s it to `people.apache.org`. - **The SSH section is dropped entirely.** It existed for `scp` deploys to `people.apache.org` and for a `known_hosts` hashing bug in Maven Wagon — a dead host and a dead code path. - **Credential handling deviates deliberately.** The old page puts the ASF LDAP password *and* the GPG passphrase in clear text in `settings.xml`. This points at [`mvn --encrypt-password`](https://maven.apache.org/guides/mini/guide-encryption.html) and `gpg-agent` instead, with a warning callout. Publishing the clear-text version on the project website was not something worth doing. - Links go to `infra.apache.org` rather than the retired `apache.org/dev/` paths. The retagging and `svn propset` notes at the bottom of that page are not ported: both are Subversion-era and the repository has been on git for years. ### Verified `bundle exec jekyll build` clean. The new `###` section appears in the generated ToC; its `####` subsections correctly do not, since `_config.yml` sets `toc_levels: 1..3`. ### Next Once this merges, the seven cwiki release pages get replaced with pointer stubs, as recorded in #324. 🤖 Generated with [Claude Code](https://claude.com/claude-code) -- 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]
