commit | 383fdc8457aae67b028a22782755180ff8d21d1e | [log] [tgz] |
---|---|---|
author | Tobias Bouschen <tobias.bouschen@googlemail.com> | Fri Jan 22 23:03:59 2021 +0100 |
committer | Tobias Bouschen <tobias.bouschen@googlemail.com> | Thu Jan 28 20:28:29 2021 +0100 |
tree | 29fa78334cf65b42d75c0349ab2ef2298e8fedee | |
parent | 766f6b85148aef2d0253dfaec828f6caee293809 [diff] |
Adjust site build workflow to preserve build artifact history Adjusts the workflow building and publishing the website to the site branch to preserve the history of the site branch. This was done to avoid issues with the Apache backend caused by force-pushing the new build results to an orphan branch every time. This new behavior is a bit more brittle than the old one as it relies on the current state of the site branch. The action will fails if the site branch is not already present. Additionally, it might also fail if the branch is in an unexpected state. But, as the action removes all existing resources, this should be unlikely. To resolve any issues caused by a missing or corrupted site branch, a future commit will introduce a recovery workflow that can be used to manually return the site branch to a usable base state.
This repository contains the sources for the Apache DB JDO website.
The website is mirrored on https://apache.github.io/db-jdo-site/.
The content and styling of the site is defined in the AsciiDoc format. It is built using Maven.
The site can be built by calling mvn clean compile
. This generates the HTML files in target/site
.
The site contains a packaged version of the JDO API javadoc. It can be updated as follows:
mvn clean install -Papache-release
in the api submodule.cp jdo-api-3.2-javadoc.jar docs/api32
.Contributions to the website are always appreciated. If you are new to this project, please have a look at our Get Involved page first.
This repository contains the JDO website source.
src/main/asciidoc
.src/main/template
.src/main/java
Contributions to this repository follow the default GitHub workflow using forks.
To contribute changes, you can follow these steps:
src/main/asciidoc
or the website menu in src/main/template
.mvn clean compile
to build the site and verify the generated website by viewing it locally with a web browser.