Author: buildbot
Date: Tue Oct 24 20:53:12 2023
New Revision: 1084521
Log:
Automatic Staging Site Publish by Buildbot
Modified:
websites/staging/commons/trunk/content/site-publish.html
Modified: websites/staging/commons/trunk/content/site-publish.html
==============================================================================
--- websites/staging/commons/trunk/content/site-publish.html (original)
+++ websites/staging/commons/trunk/content/site-publish.html Tue Oct 24
20:53:12 2023
@@ -215,8 +215,6 @@
<section>
<h2><a name="Introduction"></a>Introduction</h2>
-<p><b>THIS DESCRIPTION IS IN A STATE OF FLUX due to CMS deprecation and
related changes</b></p>
-
<p>
Commons sites use a solution based on both BuildBot (for the main site)
and svnpubsub publication based on the <a class="externalLink"
href="http://maven.apache.org/plugins/maven-scm-publish-plugin/";>maven-scm-publish-plugin</a>
@@ -235,14 +233,27 @@
<div>
<pre>mvn clean site</pre></div>
This will generate output under target/site.
+ If you are happy with the changes, commit the source updates.
-<p>After you commit, and <a class="externalLink"
href="http://ci.apache.org/builders/commons-site";>buildbot</a> handles the site
generation,
+<p>After you commit, <a class="externalLink"
href="http://ci.apache.org/builders/commons-site";>buildbot</a> handles the site
generation,
with the output published to the
<a class="externalLink"
href="https://svn.apache.org/repos/infra/websites/staging/commons/trunk/content/index.html";>staging
site</a>.
- Once satisfied, you can <a class="externalLink"
href="https://cms.apache.org/commons/publish";>publish</a> via the CMS site.
- THIS OPTION MAY SOON DISAPPEAR
+ This is then automatically published to the production site.
</p>
+
+<p>
+ If you wish to stage the changes without publication to production site,
update the site locally using
+ </p>
+<div>
+<pre>bash commons-site-build.sh</pre></div>
+ This fetches the current staging site and updates it, but does not
commit it.
+ If you wish to commit the staging site for review, commit the updated
copy
+ using a command of the form:
+
+<div>
+<pre>svn commit target/site -m 'Update the staging site prior to
deployment'</pre></div>
+
</section>
<section>
<h2><a name="Components"></a>Components</h2>
