Merging main into mkdocs, add Beta contributor's guide (hidden) to the website, create /snippets directory

.github/workflows/knative-boilerplate.yaml

@@ -42,10 +42,10 @@ jobs:
 
     steps:
 
-      - name: Set up Go 1.15.x
+      - name: Set up Go 1.16.x
         uses: actions/setup-go@v2
         with:
-          go-version: 1.15.x
+          go-version: 1.16.x
         id: go
 
       - name: Check out code

.github/workflows/knative-go-build.yaml

@@ -27,7 +27,7 @@ jobs:
     name: Build
     strategy:
       matrix:
-        go-version: [1.15.x]
+        go-version: [1.16.x]
         platform: [ubuntu-latest]
 
     runs-on: ${{ matrix.platform }}
@@ -43,7 +43,13 @@ jobs:
       - name: Check out code
         uses: actions/checkout@v2
 
+      - id: go_mod
+        uses: andstor/file-existence-action@v1
+        with:
+          files: go.mod
+
       - name: Build
+        if: ${{ steps.go_mod.outputs.files_exists == 'true' }}
         run: |
           tags="$(grep -I  -r '// +build' . | \
                 grep -v '^./vendor/' | \
@@ -55,5 +61,4 @@ jobs:
                 tr '\n' ' ')"
 
           echo "Building with tags: ${tags}"
-          go test -vet=off -tags "${tags}" -run=^$ ./... | grep -v "no test" || true
-
+          go test -vet=off -tags "${tags}" -exec echo ./...

.github/workflows/knative-go-test.yaml

@@ -31,7 +31,7 @@ jobs:
     name: Unit Tests
     strategy:
       matrix:
-        go-version: [1.15.x]
+        go-version: [1.16.x]
         platform: [ubuntu-latest]
 
     runs-on: ${{ matrix.platform }}

.github/workflows/knative-releasability.yaml

@@ -36,8 +36,8 @@ jobs:
     env:
       #########################################
       #   Update this section each release.   #
-      RELEASE: 'v0.22'
-      SLACK_CHANNEL: 'release-22'
+      RELEASE: 'v0.23'
+      SLACK_CHANNEL: 'release-23'
       #########################################
 
     steps:
@@ -54,10 +54,10 @@ jobs:
             echo "SLACK_WEBHOOK=exists" >> $GITHUB_ENV
           fi
 
-      - name: Set up Go 1.15.x
+      - name: Set up Go 1.16.x
         uses: actions/setup-go@v2
         with:
-          go-version: 1.15.x
+          go-version: 1.16.x
 
       - name: Install Dependencies
         run: GO111MODULE=on go get knative.dev/test-infra/buoy@main
@@ -110,25 +110,15 @@ jobs:
           # If we don't run `git status` before the "git diff-index" it seems
           # to list every file that's been touched by codegen.
           git status
-          FOUND_DIFF=0
-          for x in $(git diff-index --name-only HEAD --); do
-            if [ "$(basename $x)" = "go.mod" ]; then
-              continue
-            elif [ "$(basename $x)" = "go.sum" ]; then
-              continue
-            elif [ "$(basename $x)" = "modules.txt" ]; then
-              continue
-            fi
-            echo "Found non-module diff: $x"
-            FOUND_DIFF=1
-            break
-          done
+
+          CHANGED="$(git diff-index --name-only HEAD --)"
 
           # If we see no changes after the upgrade, then we are up to date.
-          if [[ "$FOUND_DIFF" -eq "0"  ]]; then
+          if [[ "$CHANGED" == "" ]]; then
               echo "VERIFY_MESSAGE=${{ github.repository }} up to date." >> $GITHUB_ENV
           else
               echo "VERIFY_MESSAGE=${{ github.repository }} is out of date." >> $GITHUB_ENV
+              echo "The following files are changed: $CHANGED"
               echo 'current=false' >> $GITHUB_ENV
           fi
 

.github/workflows/knative-release-notes.yaml

@@ -41,7 +41,7 @@ jobs:
       - name: Set up Go
         uses: actions/setup-go@v2
         with:
-          go-version: 1.15.x
+          go-version: 1.16.x
 
       - name: Install Dependencies
         run: GO111MODULE=on go get k8s.io/release/cmd/release-notes

.github/workflows/knative-style.yaml

@@ -40,10 +40,10 @@ jobs:
           importpath: golang.org/x/tools/cmd/goimports
 
     steps:
-      - name: Set up Go 1.15.x
+      - name: Set up Go 1.16.x
         uses: actions/setup-go@v2
         with:
-          go-version: 1.15.x
+          go-version: 1.16.x
         id: go
 
       - name: Check out code
@@ -89,10 +89,10 @@ jobs:
     runs-on: ubuntu-latest
 
     steps:
-      - name: Set up Go 1.15.x
+      - name: Set up Go 1.16.x
         uses: actions/setup-go@v2
         with:
-          go-version: 1.15.x
+          go-version: 1.16.x
         id: go
 
       - name: Check out code

.github/workflows/knative-verify.yaml

@@ -27,7 +27,7 @@ jobs:
     name: Verify Deps and Codegen
     strategy:
       matrix:
-        go-version: [1.15.x]
+        go-version: [1.16.x]
         platform: [ubuntu-latest]
 
     runs-on: ${{ matrix.platform }}

OWNERS

@@ -4,6 +4,8 @@ approvers:
 - docs-writers
 - technical-oversight-committee
 - steering-committee
+- knative-release-leads
+- ux-wg-leads
 reviewers:
 - docs-writers
 - docs-reviewers

OWNERS_ALIASES

@@ -167,12 +167,10 @@ aliases:
   pkg-configmap-reviewers:
   - dprotaso
   - mattmoor
-  - mdemirhan
   - vagababov
   pkg-configmap-writers:
   - dprotaso
   - mattmoor
-  - mdemirhan
   - vagababov
   pkg-controller-reviewers:
   - dprotaso
@@ -209,11 +207,9 @@ aliases:
   - evankanderson
   - julz
   serving-observability-reviewers:
-  - mdemirhan
   - skonto
   - yanweiguo
   serving-observability-writers:
-  - mdemirhan
   - yanweiguo
   serving-reviewers:
   - julz

blog/articles/set-up-a-local-knative-environment-with-kind.md

@@ -218,15 +218,15 @@ kourier.ingress.networking.knative.dev
 
 To get the same experience that you would when using a cluster that has DNS names set up, you can add a “magic” DNS provider.
 
-_nip.io_ provides a wildcard DNS setup that will automatically resolve to the IP address you put in front of nip.io.
+_sslip.io_ provides a wildcard DNS setup that will automatically resolve to the IP address you put in front of sslip.io.
 
-To patch the domain configuration for Knative Serving using nip.io, enter the command:
+To patch the domain configuration for Knative Serving using sslip.io, enter the command:
 
 ```bash
 $ kubectl patch configmap/config-domain \
   --namespace knative-serving \
   --type merge \
-  --patch '{"data":{"127.0.0.1.nip.io":""}}'
+  --patch '{"data":{"127.0.0.1.sslip.io":""}}'
 ```
 
 If you want to validate that the patch command was successful, run the command:
@@ -239,7 +239,7 @@ $ kubectl describe configmap/config-domain --namespace knative-serving
 ... (abbreviated for readability)
 Data
 ====
-127.0.0.1.nip.io:
+127.0.0.1.sslip.io:
 ----
 ...
 ```
@@ -329,20 +329,20 @@ $ kubectl get ksvc
 
 ```bash
 NAME            URL                                             LATESTCREATED         LATESTREADY   READY     REASON
-helloworld-go   http://helloworld-go.default.127.0.0.1.nip.io   helloworld-go-fqqs6                 Unknown   RevisionMissing
+helloworld-go   http://helloworld-go.default.127.0.0.1.sslip.io   helloworld-go-fqqs6                 Unknown   RevisionMissing
 ```
 
 ```bash
 NAME            URL                                             LATESTCREATED         LATESTREADY           READY   REASON
-helloworld-go   http://helloworld-go.default.127.0.0.1.nip.io   helloworld-go-fqqs6   helloworld-go-fqqs6   True
+helloworld-go   http://helloworld-go.default.127.0.0.1.sslip.io   helloworld-go-fqqs6   helloworld-go-fqqs6   True
 ```
 
 The final step is to test your application, by checking that the code returns what you expect. You can do this by sending a cURL request to the URL listed above.
 
 Because this example mapped port 80 of the host to be forwarded to the cluster and set the DNS, you can use the exact URL.
 
 ```bash
-$ curl -v http://helloworld-go.default.127.0.0.1.nip.io
+$ curl -v http://helloworld-go.default.127.0.0.1.sslip.io
 ```
 
 ```bash

community/samples/_index.md

@@ -14,7 +14,7 @@ something isn't working, lend a helping hand and fix it in a PR.
 
 [Learn more about the lifespan of samples](https://github.com/knative/docs/tree/main/CONTRIBUTING.md#user-focused-content)
 
-[**See all Knative code samples**](../../docs/samples.md)
+[**See all Knative code samples**](../../docs/samples)
 
 ### Interactive serving sample
 
@@ -30,7 +30,7 @@ Knative Serving sample apps.
 
 | Sample Name | Description | Language(s) |
 | ----------- | ----------- | ----------- |
-| Hello World | A quick introduction to Knative Serving that highlights how to deploy an app. | [Clojure](./serving/helloworld-clojure/README.md), [Dart](./serving/helloworld-dart/README.md), [Elixir](./serving/helloworld-elixir/README.md), [Haskell](./serving/helloworld-haskell/README.md), [Java - Micronaut](./serving/helloworld-java-micronaut/README.md), [Java - Quarkus](./serving/helloworld-java-quarkus/README.md), [R - Go Server](./serving/helloworld-r/README.md), [Rust](./serving/helloworld-rust/README.md), [Swift](./serving/helloworld-swift/README.md), [Vertx](./serving/helloworld-vertx/README.md) |
+| Hello World | A quick introduction to Knative Serving that highlights how to deploy an app. | [Clojure](./serving/helloworld-clojure/), [Dart](./serving/helloworld-dart/), [Elixir](./serving/helloworld-elixir/), [Haskell](./serving/helloworld-haskell/), [Java - Micronaut](./serving/helloworld-java-micronaut/), [Java - Quarkus](./serving/helloworld-java-quarkus/), [R - Go Server](./serving/helloworld-r/), [Rust](./serving/helloworld-rust/), [Swift](./serving/helloworld-swift/), [Vertx](./serving/helloworld-vertx/) |
 | Machine Learning | A quick introduction to using Knative Serving to serve machine learning models | [Python - BentoML](./serving/machinelearning-python-bentoml)
 
 #### Eventing and Eventing Resources samples
@@ -45,4 +45,3 @@ Knative `kn` Client sample workflows and apps.
 | Sample Name | Description |
 | ----------- | ----------- |
 | [knfun](https://github.com/maximilien/knfun) | Knative micro-functions (Twitter and Watson APIs) demo using the `kn` client. |
-

community/samples/serving/helloworld-clojure/index.md

@@ -12,7 +12,7 @@ specified, it will use "World" as the TARGET.
 ## Prerequisites
 
 - A Kubernetes cluster with Knative installed and DNS configured. Follow the
-  [installation instructions](../../../../docs/install/README.md) if you need to create
+  [installation instructions](../../../../docs/install/) if you need to create
   one.
 - [Docker](https://www.docker.com) installed and running on your local machine,
   and a Docker Hub account configured (we'll use it for a container registry).
@@ -142,14 +142,14 @@ folder) you're ready to build and deploy the sample app.
    ```
    kubectl get ksvc helloworld-clojure --output=custom-columns=NAME:.metadata.name,URL:.status.url
    NAME                URL
-   helloworld-clojure  http://helloworld-clojure.default.1.2.3.4.xip.io
+   helloworld-clojure  http://helloworld-clojure.default.1.2.3.4.sslip.io
    ```
 
 1. Now you can make a request to your app and see the result. Replace
    the URL below with the URL returned in the previous command.
 
    ```shell
-   curl http://helloworld-clojure.default.1.2.3.4.xip.io
+   curl http://helloworld-clojure.default.1.2.3.4.sslip.io
    Hello World!
    ```
 
@@ -160,4 +160,3 @@ To remove the sample app from your cluster, delete the service record:
 ```shell
 kubectl delete --filename service.yaml
 ```
-

community/samples/serving/helloworld-dart/index.md

@@ -13,7 +13,7 @@ that you can use for testing. It reads in the env variable `TARGET` and prints
 ## Prerequisites
 
 - A Kubernetes cluster with Knative installed and DNS configured. Follow the
-  [installation instructions](../../../../docs/install/README.md) if you need to create
+  [installation instructions](../../../../docs/install/) if you need to create
   one.
 - [Docker](https://www.docker.com) installed and running on your local machine,
   and a Docker Hub account configured (we'll use it for a container registry).
@@ -140,14 +140,14 @@ folder) you're ready to build and deploy the sample app.
    ```
    kubectl get ksvc helloworld-dart  --output=custom-columns=NAME:.metadata.name,URL:.status.url
    NAME             URL
-   helloworld-dart  http://helloworld-dart.default.1.2.3.4.xip.io
+   helloworld-dart  http://helloworld-dart.default.1.2.3.4.sslip.io
    ```
 
 1. Now you can make a request to your app and see the result. Replace
    the URL below with the URL returned in the previous command.
 
    ```shell
-   curl http://helloworld-dart.default.1.2.3.4.xip.io
+   curl http://helloworld-dart.default.1.2.3.4.sslip.io
    Hello Dart Sample v1
    ```
 

community/samples/serving/helloworld-deno/index.md

@@ -19,7 +19,7 @@ cd knative-docs/docs/serving/samples/hello-world/helloworld-deno
 ## Before you begin
 
 - A Kubernetes cluster with Knative installed. Follow the
-  [installation instructions](../../../../docs/install/README.md) if you need to
+  [installation instructions](../../../../docs/install/) if you need to
   create one.
 - [Docker](https://www.docker.com) installed and running on your local machine,
   and a Docker Hub account configured (we'll use it for a container registry).
@@ -121,20 +121,20 @@ folder) you're ready to build and deploy the sample app.
 
    ```shell
    NAME                URL
-   helloworld-deno        http://helloworld-deno.default.1.2.3.4.xip.io
+   helloworld-deno        http://helloworld-deno.default.1.2.3.4.sslip.io
    ```
 
 1. Now you can make a request to your app and see the result. Replace
    the URL below with the URL returned in the previous command.
 
    ```shell
-   curl http://helloworld-deno.default.1.2.3.4.xip.io
+   curl http://helloworld-deno.default.1.2.3.4.sslip.io
    ```
 
    Example:
 
    ```shell
-   curl http://helloworld-deno.default.1.2.3.4.xip.io
+   curl http://helloworld-deno.default.1.2.3.4.sslip.io
    [1] "Hello R Sample v1!"
    ```
 
@@ -147,4 +147,3 @@ To remove the sample app from your cluster, delete the service record:
 ```shell
 kubectl delete --filename service.yaml
 ```
-

community/samples/serving/helloworld-elixir/index.md

@@ -166,14 +166,14 @@ above.
     kubectl get ksvc helloworld-elixir --output=custom-columns=NAME:.metadata.name,URL:.status.url
 
     NAME                URL
-    helloworld-elixir   http://helloworld-elixir.default.1.2.3.4.xip.io
+    helloworld-elixir   http://helloworld-elixir.default.1.2.3.4.sslip.io
     ```
 
 1.  Now you can make a request to your app to see the results. Replace
     `{IP_ADDRESS}` with the address you see returned in the previous step.
 
         ```shell
-        curl http://helloworld-elixir.default.1.2.3.4.xip.io
+        curl http://helloworld-elixir.default.1.2.3.4.sslip.io
 
         ...
         # HTML from your application is returned.