You are viewing a plain text version of this content. The canonical link for it is here.
Posted to cvs@incubator.apache.org by bd...@apache.org on 2019/07/22 14:18:33 UTC
[incubator] branch master updated: Make the automated publishing
info more prominent
This is an automated email from the ASF dual-hosted git repository.
bdelacretaz pushed a commit to branch master
in repository https://gitbox.apache.org/repos/asf/incubator.git
The following commit(s) were added to refs/heads/master by this push:
new 18cd6ed Make the automated publishing info more prominent
18cd6ed is described below
commit 18cd6ed02552b1cccc217cc329f936ffe75c43ce
Author: Bertrand Delacretaz <bd...@apache.org>
AuthorDate: Mon Jul 22 16:18:29 2019 +0200
Make the automated publishing info more prominent
---
README.md | 43 +++++++++++++++++++++----------------------
1 file changed, 21 insertions(+), 22 deletions(-)
diff --git a/README.md b/README.md
index 737bce9..df5bd42 100644
--- a/README.md
+++ b/README.md
@@ -10,6 +10,25 @@ and raise a pull request.
Use the [general@incubator.a.o](https://lists.apache.org/list.html?general@incubator.apache.org) mailing list to contact
the Incubator PMC which manages this website.
+## Automated publishing - Website and Clutch data
+
+Commits to the `master` branch are automatically checked out and built using `build_site.sh` by the
+[Incubator GIT Site - part 2](https://builds.apache.org/view/H-L/view/Incubator/job/Incubator%20GIT%20Site%20-%20part%202/)
+Jenkins job. The results are pushed to the [`content` folder of the `asf-site` branch](https://github.com/apache/incubator/tree/asf-site/content)
+which is in turn published automatically to http://incubator.apache.org/ by the ASF's `gitwcsub` mechanism.
+
+The data for http://incubator.apache.org/clutch/ takes longer to build so it is handled by a separate
+[SVN Clutch Analysis - part 1](https://builds.apache.org/view/H-L/view/Incubator/job/Incubator%20SVN%20Clutch%20Analysis%20-%20part%201/)
+Jenkins job that runs the `build_clutch.sh` script that's scheduled to run regularly. The results are stored in the
+[`reserve` folder of the `asf-site` branch](https://github.com/apache/incubator/tree/asf-site/reserve)
+
+For now that Clutch data is still managed in svn, at http://svn.apache.org/repos/asf/incubator/public/trunk/ , see
+the build scripts for more info. The projects folder (podling status pages) and the ip-clearance folders are also still in svn
+and the html is built using `ant docs` in the `build_clutch.sh` script.
+
+Any build failures are reported to *[cvs@incubator.a.o](https://lists.apache.org/list.html?cvs@incubator.apache.org)*
+mailing list.
+
## Prerequisites for building the website locally
The website is built using [JBake](https://jbake.org/) and Groovy templates.
@@ -22,7 +41,7 @@ The builds for the website do require internet access.
- `export JBAKE_HOME=/usr/local/Cellar/jbake/2.6.4`
- Ensure that you have a JVM locally, e.g. [OpenJDK](http://openjdk.java.net/install/)
-## Building & testing the site
+## Building & testing the site locally
To test the site locally, use
@@ -33,7 +52,7 @@ quickly if any changes are made.
That script can be called with any of the [arguments you would pass to jbake](https://jbake.org/docs/2.6.4/#bake_command).
-### Clutch and Legacy SVN Content (careful)
+### Building the Clutch and Legacy SVN Content (if you know what you're doing)
**Warning** do not run the clutch build scripts unless you are sure you understand them, and please be careful not to commit any of the resulting assets and pages to the git master branch. That content and data is only committed to the `asf-site`
branch's `reserve`folder as mentioned below.
@@ -41,26 +60,6 @@ branch's `reserve`folder as mentioned below.
The `build_local_clutch.sh` script can be used to build the Clutch data, but that's updated automatically by the Jenkins
builds as `build_clutch.sh` mentioned below so it's not required unless you want to test that.
-
-## Automated builds - website and Clutch data
-
-Commits to the `master` branch are automatically checked out and built using `build_site.sh` by the
-[Incubator GIT Site - part 2](https://builds.apache.org/view/H-L/view/Incubator/job/Incubator%20GIT%20Site%20-%20part%202/)
-Jenkins job. The results are pushed to the [`content` folder of the `asf-site` branch](https://github.com/apache/incubator/tree/asf-site/content)
-which is in turn published automatically to http://incubator.apache.org/ by the ASF's `gitwcsub` mechanism.
-
-The data for http://incubator.apache.org/clutch/ takes longer to build so it is handled by a separate
-[SVN Clutch Analysis - part 1](https://builds.apache.org/view/H-L/view/Incubator/job/Incubator%20SVN%20Clutch%20Analysis%20-%20part%201/)
-Jenkins job that runs the `build_clutch.sh` script that's scheduled to run regularly. The results are stored in the
-[`reserve` folder of the `asf-site` branch](https://github.com/apache/incubator/tree/asf-site/reserve)
-
-For now that Clutch data is still managed in svn, at http://svn.apache.org/repos/asf/incubator/public/trunk/ , see
-the build scripts for more info. The projects folder (podling status pages) and the ip-clearance folders are also still in svn
-and the html is built using `ant docs` in the `build_clutch.sh` script.
-
-Any build failures are reported to *[cvs@incubator.a.o](https://lists.apache.org/list.html?cvs@incubator.apache.org)*
-mailing list.
-
## Asciidoctor
Most of the pages in the site are written using Asciidoctor.
---------------------------------------------------------------------
To unsubscribe, e-mail: cvs-unsubscribe@incubator.apache.org
For additional commands, e-mail: cvs-help@incubator.apache.org
Re: [incubator] branch master updated: Make the automated publishing
info more prominent
Posted by Dave Fisher <wa...@apache.org>.
Thank you Bertrand.
Regards,
Dave
> On Jul 22, 2019, at 7:18 AM, bdelacretaz@apache.org wrote:
>
> This is an automated email from the ASF dual-hosted git repository.
>
> bdelacretaz pushed a commit to branch master
> in repository https://gitbox.apache.org/repos/asf/incubator.git
>
>
> The following commit(s) were added to refs/heads/master by this push:
> new 18cd6ed Make the automated publishing info more prominent
> 18cd6ed is described below
>
> commit 18cd6ed02552b1cccc217cc329f936ffe75c43ce
> Author: Bertrand Delacretaz <bd...@apache.org>
> AuthorDate: Mon Jul 22 16:18:29 2019 +0200
>
> Make the automated publishing info more prominent
> ---
> README.md | 43 +++++++++++++++++++++----------------------
> 1 file changed, 21 insertions(+), 22 deletions(-)
>
> diff --git a/README.md b/README.md
> index 737bce9..df5bd42 100644
> --- a/README.md
> +++ b/README.md
> @@ -10,6 +10,25 @@ and raise a pull request.
> Use the [general@incubator.a.o](https://lists.apache.org/list.html?general@incubator.apache.org) mailing list to contact
> the Incubator PMC which manages this website.
>
> +## Automated publishing - Website and Clutch data
> +
> +Commits to the `master` branch are automatically checked out and built using `build_site.sh` by the
> +[Incubator GIT Site - part 2](https://builds.apache.org/view/H-L/view/Incubator/job/Incubator%20GIT%20Site%20-%20part%202/)
> +Jenkins job. The results are pushed to the [`content` folder of the `asf-site` branch](https://github.com/apache/incubator/tree/asf-site/content)
> +which is in turn published automatically to http://incubator.apache.org/ by the ASF's `gitwcsub` mechanism.
> +
> +The data for http://incubator.apache.org/clutch/ takes longer to build so it is handled by a separate
> +[SVN Clutch Analysis - part 1](https://builds.apache.org/view/H-L/view/Incubator/job/Incubator%20SVN%20Clutch%20Analysis%20-%20part%201/)
> +Jenkins job that runs the `build_clutch.sh` script that's scheduled to run regularly. The results are stored in the
> +[`reserve` folder of the `asf-site` branch](https://github.com/apache/incubator/tree/asf-site/reserve)
> +
> +For now that Clutch data is still managed in svn, at http://svn.apache.org/repos/asf/incubator/public/trunk/ , see
> +the build scripts for more info. The projects folder (podling status pages) and the ip-clearance folders are also still in svn
> +and the html is built using `ant docs` in the `build_clutch.sh` script.
> +
> +Any build failures are reported to *[cvs@incubator.a.o](https://lists.apache.org/list.html?cvs@incubator.apache.org)*
> +mailing list.
> +
> ## Prerequisites for building the website locally
>
> The website is built using [JBake](https://jbake.org/) and Groovy templates.
> @@ -22,7 +41,7 @@ The builds for the website do require internet access.
> - `export JBAKE_HOME=/usr/local/Cellar/jbake/2.6.4`
> - Ensure that you have a JVM locally, e.g. [OpenJDK](http://openjdk.java.net/install/)
>
> -## Building & testing the site
> +## Building & testing the site locally
>
> To test the site locally, use
>
> @@ -33,7 +52,7 @@ quickly if any changes are made.
>
> That script can be called with any of the [arguments you would pass to jbake](https://jbake.org/docs/2.6.4/#bake_command).
>
> -### Clutch and Legacy SVN Content (careful)
> +### Building the Clutch and Legacy SVN Content (if you know what you're doing)
>
> **Warning** do not run the clutch build scripts unless you are sure you understand them, and please be careful not to commit any of the resulting assets and pages to the git master branch. That content and data is only committed to the `asf-site`
> branch's `reserve`folder as mentioned below.
> @@ -41,26 +60,6 @@ branch's `reserve`folder as mentioned below.
> The `build_local_clutch.sh` script can be used to build the Clutch data, but that's updated automatically by the Jenkins
> builds as `build_clutch.sh` mentioned below so it's not required unless you want to test that.
>
> -
> -## Automated builds - website and Clutch data
> -
> -Commits to the `master` branch are automatically checked out and built using `build_site.sh` by the
> -[Incubator GIT Site - part 2](https://builds.apache.org/view/H-L/view/Incubator/job/Incubator%20GIT%20Site%20-%20part%202/)
> -Jenkins job. The results are pushed to the [`content` folder of the `asf-site` branch](https://github.com/apache/incubator/tree/asf-site/content)
> -which is in turn published automatically to http://incubator.apache.org/ by the ASF's `gitwcsub` mechanism.
> -
> -The data for http://incubator.apache.org/clutch/ takes longer to build so it is handled by a separate
> -[SVN Clutch Analysis - part 1](https://builds.apache.org/view/H-L/view/Incubator/job/Incubator%20SVN%20Clutch%20Analysis%20-%20part%201/)
> -Jenkins job that runs the `build_clutch.sh` script that's scheduled to run regularly. The results are stored in the
> -[`reserve` folder of the `asf-site` branch](https://github.com/apache/incubator/tree/asf-site/reserve)
> -
> -For now that Clutch data is still managed in svn, at http://svn.apache.org/repos/asf/incubator/public/trunk/ , see
> -the build scripts for more info. The projects folder (podling status pages) and the ip-clearance folders are also still in svn
> -and the html is built using `ant docs` in the `build_clutch.sh` script.
> -
> -Any build failures are reported to *[cvs@incubator.a.o](https://lists.apache.org/list.html?cvs@incubator.apache.org)*
> -mailing list.
> -
> ## Asciidoctor
>
> Most of the pages in the site are written using Asciidoctor.
>
>
> ---------------------------------------------------------------------
> To unsubscribe, e-mail: cvs-unsubscribe@incubator.apache.org
> For additional commands, e-mail: cvs-help@incubator.apache.org
>
---------------------------------------------------------------------
To unsubscribe, e-mail: general-unsubscribe@incubator.apache.org
For additional commands, e-mail: general-help@incubator.apache.org