dsmiley commented on code in PR #2767:
URL: https://github.com/apache/solr/pull/2767#discussion_r1802072457
##########
dev-docs/asf-jenkins.adoc:
##########
Review Comment:
Maybe rename to include "ci-" prefix?
##########
dev-docs/asf-jenkins.adoc:
##########
@@ -0,0 +1,74 @@
+= ASF Jenkins Setup
+:toc: left
+
+The Solr project uses a Jenkins instance provided by the Apache Software
Foundation ("ASF") for running tests, validation, etc.
+
+This file aims to document our ASF Jenkins usage and administrator, to prevent
it from becoming "tribal knowledge" understood by just a few.
+
Review Comment:
Let's include a link to Jenkins :-)
##########
dev-docs/asf-jenkins.adoc:
##########
@@ -0,0 +1,74 @@
+= ASF Jenkins Setup
+:toc: left
+
+The Solr project uses a Jenkins instance provided by the Apache Software
Foundation ("ASF") for running tests, validation, etc.
+
+This file aims to document our ASF Jenkins usage and administrator, to prevent
it from becoming "tribal knowledge" understood by just a few.
+
+== Jobs
+
+We run a number of jobs on Jenkins, each validating an overlapping set of
concerns:
+
+* `Solr-Artifacts-*` - daily jobs that run `./gradlew assemble` to ensure that
build artifacts (except docker images) can be created successfully
+* `Solr-check-*` - "hourly" jobs that run all project tests and static
analysis (i.e. `test`, `integrationTest`, and `check`)
+* `Solr-Docker-Nightly-*` - daily jobs that `./gradlew testDocker dockerPush`
to validate docker image packaging. Snapshot images are pushed to
hub.docker.com
+* `Solr-reference-guide-*` - hourly jobs that build the Solr reference guide
via `./gradlew checkSite` and push the resulting artifact to the
staging/preview site `nightlies.apache.org`
+* `Solr-Smoketest-*` - daily jobs that produce a snapshot release (via the
`assembleRelease` task) and run the release smoketester
+
+Unless otherwise specified, all builds currently run using JDK 11.
Review Comment:
Let's not write too much information here that could get out of sync with
reality
--
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: issues-unsubscr...@solr.apache.org
For queries about this service, please contact Infrastructure at:
us...@infra.apache.org
---------------------------------------------------------------------
To unsubscribe, e-mail: issues-unsubscr...@solr.apache.org
For additional commands, e-mail: issues-h...@solr.apache.org
