update fork

.github/CODEOWNERS

@@ -1,2 +1,2 @@
 # Global Owners
-* @rkratky @themr0c @boczkowska @MichalMaler @eclipse/ecd-che-docs-reviewers
+* @rkratky @themr0c @max-cx @tstastna @eclipse/ecd-che-docs-reviewers

.github/PULL_REQUEST_TEMPLATE.md

@@ -1,22 +1,30 @@
-> Read our [Contribution guide](https://github.com/eclipse/che-docs/blob/master/CONTRIBUTING.adoc) before submitting a PR.
 
-### What does this PR do?
+<!-- 
+Please use one of the following prefixes for the title:
+docs: Documentation not including procedures. Engineering review is mandatory.
+procedures: Documentation including procedures. Testing procedures is mandatory. Engineering and QE review is mandatory (Engineering can review on behalf of QE). 
+chore: Routine, release, tooling, version upgrades.
+fix: Fix build, language, links, or metadata.
+-->
 
+<!-- Read our [Contribution guide](https://github.com/eclipse/che-docs/blob/master/CONTRIBUTING.adoc) before submitting a PR. -->
 
-### What issues does this PR fix or reference?
+## What does this pull request change?
 
+## What issues does this pull request fix or reference?
 
-### Specify the version of the product this PR applies to.
+## Specify the version of the product this pull request applies to
 
+## Pull Request checklist
 
-### PR Checklist
+The author and the reviewers validate the content of this pull request with the following checklist, in addition to the [automated tests](code_review_checklist.adoc).
 
-As the author of this Pull Request I made sure that:
-
-- [ ] `vale` has been run successfully against the PR branch
-- [ ] Link checker has been run successfully against the PR branch
-- [ ] Documentation describes a scenario that is already covered by QE tests, otherwise an issue has been created and acknowledged by Che QE team
-- [ ] Changed article references are updated where they are used (or a redirect has been set up on the docs side):
-    - [ ] Dashboard [branding.json](https://github.com/eclipse/che-dashboard/blob/master/src/components/branding/branding.json)
+- Any procedure:
+  - [ ] Successfully tested.
+- Any page or link rename:
+  - [ ] The page contains a redirection for the previous URL.
+  - Propagate the URL change in:
+    - [ ] Dashboard [default branding data](https://github.com/eclipse-che/che-dashboard/blob/main/packages/dashboard-frontend/src/services/bootstrap/branding.constant.ts)
     - [ ] Chectl [constants.ts](https://github.com/che-incubator/chectl/blob/master/src/constants.ts)
-
+- [ ] Builds on [Eclipse Che hosted by Red Hat](https://workspaces.openshift.com).
+- [ ] the *`Validate language on files added or modified`* step reports no vale warnings.

.github/workflows/build-and-validate-on-pr.yaml

@@ -0,0 +1,84 @@
+#
+# Copyright (c) 2020 Red Hat, Inc.
+# This program and the accompanying materials are made
+# available under the terms of the Eclipse Public License 2.0
+# which is available at https://www.eclipse.org/legal/epl-2.0/
+#
+# SPDX-License-Identifier: EPL-2.0
+#
+
+# Name is reused in `publish-netlify.yml`
+name: "Build and validate PR"
+
+on:
+  - pull_request
+
+jobs:
+  build:
+    name: link checker # This job name is set as mandatory in the GitHub configuration.
+    runs-on: ubuntu-20.04
+    container: "quay.io/eclipse/che-docs:latest"
+    steps:
+      - name: Checkout code
+        uses: actions/checkout@v2
+        with:
+          fetch-depth: 0 # Necessary for git diff in vale step
+
+      # Cache for Antora UI and Htmltest.
+      # See: https://docs.github.com/en/actions/guides/caching-dependencies-to-speed-up-workflows
+      # Htmltest accepts 2 weeks old cache for the status code of checked external URLs
+      # See: https://github.com/wjdp/htmltest
+      # Refresh the cache every week to avoid a stale cache for htmltest
+      # See: https://github.com/actions/cache
+      # See: http://man7.org/linux/man-pages/man1/date.1.html
+      - name: Get Date
+        id: get-date
+        run: |
+          echo "::set-output name=yearweek::$(/bin/date -u "+%Y%U")"
+        shell: bash
+      - name: Restore cache
+        uses: actions/cache@v2
+        env:
+          cache-name: cache
+        with:
+          path: .cache
+          key: ${{ steps.get-date.outputs.yearweek }}
+
+      - name: Build using antora # and fail on warning
+        id: antora-build
+        run: CI=true antora generate antora-playbook-for-development.yml --stacktrace 2>&1 | (tee | grep  WARNING && exit 42 || exit 0)
+
+      - name: Upload artifact doc-content
+        uses: actions/upload-artifact@v2
+        with:
+          name: doc-content
+          path: build/site
+
+      - name: Store PR info for publish-netlify
+        run: |
+          echo "${{ github.event.number }}" > PR_NUMBER
+          echo "${{ github.event.pull_request.head.sha }}" > PR_SHA
+
+      - name: Upload artifact pull-request-number for publish-netlify
+        uses: actions/upload-artifact@v2
+        with:
+          name: pull-request-number
+          path: PR_NUMBER
+
+      - name: Upload artifact pull-request-sha for publish-netlify
+        uses: actions/upload-artifact@v2
+        with:
+          name: pull-request-sha
+          path: PR_SHA
+
+      - name: Validate links using htmltest
+        id: validate-links
+        run: htmltest
+
+      - name: Report Unused Images
+        run: tools/detect-unused-images.sh
+
+      - name: Validate language on files added or modified
+        run: |
+          tools/get_vale_styles.sh
+          tools/validate_language_changes.sh

.github/workflows/build-and-validate-on-push.yaml

@@ -0,0 +1,68 @@
+#
+# Copyright (c) 2020 Red Hat, Inc.
+# This program and the accompanying materials are made
+# available under the terms of the Eclipse Public License 2.0
+# which is available at https://www.eclipse.org/legal/epl-2.0/
+#
+# SPDX-License-Identifier: EPL-2.0
+#
+
+# GitHub Actions configuration file for htmltest
+# See: https://github.com/wjdp/htmltest
+
+name: Build and validate
+on:
+  push:
+    branches:
+      - main
+      - master
+jobs:
+  build:
+    name: Build and validate
+    runs-on: ubuntu-20.04
+    container: "quay.io/eclipse/che-docs:latest"
+    steps:
+      - name: Checkout code
+        uses: actions/checkout@v2
+        with:
+          fetch-depth: 0
+
+      # Cache for Antora UI and Htmltest.
+      # See: https://docs.github.com/en/actions/guides/caching-dependencies-to-speed-up-workflows
+      # Htmltest accepts 2 weeks old cache for the status code of checked external URLs
+      # See: https://github.com/wjdp/htmltest
+      # Refresh the cache every week to avoid a stale cache for htmltest
+      # See: https://github.com/actions/cache
+      # See: http://man7.org/linux/man-pages/man1/date.1.html
+      - name: Get Date
+        id: get-date
+        run: |
+          echo "::set-output name=yearweek::$(/bin/date -u "+%Y%U")"
+        shell: bash
+      - name: Restore cache
+        uses: actions/cache@v2
+        env:
+          cache-name: cache
+        with:
+          path: .cache
+          key: ${{ steps.get-date.outputs.yearweek }}
+
+      - name: Build using antora
+        id: antora-build
+        run: CI=true antora generate antora-playbook-for-development.yml --stacktrace
+
+      - name: Upload artifact doc-content
+        uses: actions/upload-artifact@v2
+        with:
+          name: doc-content
+          path: build/site
+
+      - name: Validate links using htmltest
+        id: validate-links
+        run: htmltest
+
+      - name: Report Unused Images
+        run: tools/detect-unused-images.sh
+
+      - name: Count Vale alerts
+        run: tools/count_vale_errors.sh

.github/workflows/call-publication-builder.yaml

@@ -0,0 +1,24 @@
+#
+# Copyright (c) 2020 Red Hat, Inc.
+# This program and the accompanying materials are made
+# available under the terms of the Eclipse Public License 2.0
+# which is available at https://www.eclipse.org/legal/epl-2.0/
+#
+# SPDX-License-Identifier: EPL-2.0
+#
+
+name: "Call publication builder"
+
+on:
+  push:
+    branches:
+      - "7.*.x"
+      - main
+      - master
+
+jobs:
+  call-publication-builder:
+    name: "Call publication builder"
+    uses: eclipse/che-docs/.github/workflows/publication-builder.yaml@publication-builder
+    secrets:
+      CHE_BOT_GITHUB_TOKEN: ${{ secrets.CHE_BOT_GITHUB_TOKEN }}

.github/workflows/che-variables-update.yml

@@ -0,0 +1,37 @@
+# This Workflow performs an update of Che variables
+name: Update Che variables in the docs
+on:
+  workflow_dispatch:
+    inputs:
+      branch:
+        description: 'Branch in which to update variables'
+        required: true
+        default: ''
+jobs:
+  build:
+    name: Create Release
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v2
+        with:
+          fetch-depth: 0
+      - name: Create Release
+        run: |
+          git config --global user.name "Mykhailo Kuznietsov"
+          git config --global user.email "mkuznets@redhat.com"
+          export GITHUB_TOKEN=${{ secrets.CHE_BOT_GITHUB_TOKEN }}
+
+          BASE_BRANCH=${{ github.event.inputs.branch }}
+          git checkout ${BASE_BRANCH}
+          ./tools/environment_docs_gen.sh
+
+          if git diff --name-status --exit-code; then
+            echo "[INFO] no changes detected, pull request will not be created"
+          else           
+            PR_BRANCH="pr-update-base-images-$(date +%s)"
+            git checkout -b ${PR_BRANCH}
+            git add -A
+            git commit -sm "chore: Update Che variables"
+            git push origin ${PR_BRANCH}
+            hub pull-request --base ${BASE_BRANCH} --head ${PR_BRANCH} -m "chore: Update Che variables in ${PR_BRANCH}"
+          fi