update docs for CI config [skip ci]

- fix name of pipeline in docs
- update instructions for configuring pipeline

Author: mojavelinux

Jenkinsfile

@@ -1,22 +1,20 @@
 #!/bin/env groovy
 
 def githubApiTokenCredentialsId = 'docs-robot-api-key'
-
 def githubApiTokenCredentials = string(credentialsId: githubApiTokenCredentialsId, variable: 'GITHUB_API_TOKEN')
 
 // Jenkins job configuration
 // -------------------------
 // Category: Multibranch Pipeline
-// Pipeline name: release-docs-ui-bundle
+// Pipeline name: docs-ui-sandbox
 // Branch Sources: Single repository & branch
-// Name: master
+// Name: cloud
 // Source Code Management: Git
-// Repository URL: https://github.com/couchbase/docs-ui
+// Repository URL: https://github.com/couchbase/docs-ui-sandbox
 // Credentials: - none -
-// Refspec: +refs/heads/master:refs/remotes/origin/master
-// Branch specifier: refs/heads/master
-// Advanced clone behaviors: [ ] Fetch tags, [x] Honor refspec on initial clone, [x] Shallow clone (depth: 3)
-// Polling ignores commits with certain messages: (?s)(?:Release v\d+|.*\[skip .+?\]).*
+// Branch specifier: refs/heads/cloud
+// Advanced clone behaviors: [ ] Fetch tags, [x] Honor refspec on initial clone, [x] Shallow clone, Shallow clone depth: 5
+// Polling ignores commits with certain messages: (?s)(?:Release |.*\[skip .+?\]).*
 // Build Configuration:
 // Mode: by Jenkinsfile
 // Script Path: Jenkinsfile

README.adoc

@@ -198,7 +198,7 @@ If you need to package the UI so you can use it to generate the documentation si
 If any errors are reported by lint, you'll need to fix them.
 
 When the command completes successfully, the UI bundle will be available at [.path]_build/ui-bundle.zip_.
-You can point Antora at this bundle using the `--ui-bundle-url` command-line option (e.g., `--ui-bundle-url=../docs-ui/build/ui-bundle.zip`).
+You can point Antora at this bundle using the `--ui-bundle-url` command-line option (e.g., `--ui-bundle-url=../docs-ui-sandbox/build/ui-bundle.zip`).
 
 == Control the Visual Appearance of Pages
 
@@ -437,12 +437,12 @@ Releasing the UI bundle consists of the following tasks:
 Fortunately, you don't have to do any of these steps yourself.
 These steps are fully automated by the `gulp release` task.
 In fact, you don't even have to run the `gulp release` task manually.
-When a commit is pushed to the master branch of the repository, it triggers the CI job named *release-docs-ui-bundle*, which executes the `gulp release` task using pre-configured credentials.
+When a commit is pushed to the master branch of the repository, it triggers the CI job named *docs-ui-sandbox*, which executes the `gulp release` task using pre-configured credentials.
 
 IMPORTANT: A release will only be made if the project validates.
 To validate the project, run `gulp pack` before pushing your changes to GitHub.
 
-The release-docs-ui-bundle CI job is already configured, so there's nothing you need to do to make automated release work.
+The docs-ui-sandbox CI job is already configured, so there's nothing you need to do to make automated release work.
 All you have to do is commit your changes and push those commits to the master branch of the git repository.
 A few seconds later, a new bundle will be available for use with Antora.
 Run `git pull` to retrieve the updated README that includes the new URL.
@@ -475,7 +475,7 @@ In the CI job configuration, covered in the next section, you'll learn how this
 === CI Job Configuration
 
 Jenkins is used to execute the CI job that publishes the UI bundle.
-The job is named *release-docs-ui-bundle* and can be found under the *Antora* folder in the Jenkins server managed by the Couchbase docs team.
+The job is named *docs-ui-sandbox* and can be found under the *Antora* folder in the Jenkins server managed by the Couchbase docs team.
 This section describes in detail how that job has been configured in case it must be recreated.
 
 The release is performed by the cb-docs-robot GitHub account, which interacts with GitHub entirely using the GitHub API.
@@ -484,10 +484,10 @@ The release script authenticates with the GitHub API as the cb-docs-robot user u
 Create a new CI job from the Pipeline project template.
 On the configuration screen, select or populate the following settings:
 
-.Configuration details for the Antora/release-docs-ui-bundle CI job
+.Configuration details for the Antora/docs-ui-sandbox CI job
 ====
 General::
-* _Project name:_ `release-docs-ui-bundle`
+* _Project name:_ `docs-ui-sandbox`
 * _Description:_ Packs, tags, and releases the UI bundle whenever a non-ignored commit is pushed to the master branch of this repository.
 * [x] GitHub project
  ** _Project url:_ `pass:a[{url-project}]`