This project is used to update the main Apache Struts website http://struts.apache.org/
See the update website documentation on how to push changes online. However as ASF is using aggressive caching, for a while one still may need to forcely reload the page (CMD+R or Shift+F5) after changes.

Site is generated by Jekyll and uses pure html either markdown format. To test website locally you can use the below command:

bundle exec jekyll serve -w --trace --host 0.0.0.0

or you can use Docker (please install it first) with one of the provided scripts:

./docker-run.fish

when running fish-shell, or:

./docker-run.sh

when running Bash or Sh.

The continuously generated website can then be accessed at http://localhost:4000

All pages are generated into the content folder.

There are two scripts used to build the image but this should be used only when Dockerfile was modified.

Some redirect rules are configured in source/.htaccess file.

When announcing a new release, update the following files together:

1. _config.yml - bump current_version / prev_version (and the matching *_short and release_date variables).
2. source/announce-YYYY.md - add the announcement entry for the new release in the current year's file.
3. source/releases.md - move the version that has just been superseded into the Prior Releases table so the page reflects what is no longer the recommended download.