Testtool initial documentation

Signed-off-by: apostasie <[email protected]>

Author: apostasie

.github/workflows/test-canary.yml

@@ -112,5 +112,5 @@ jobs:
           ctrdVersion: ${{ env.CONTAINERD_VERSION }}
         run: powershell hack/configure-windows-ci.ps1
       - name: "Run integration tests"
-        # See https://github.com/containerd/nerdctl/blob/main/docs/dev/testing.md#about-parallelization
+        # See https://github.com/containerd/nerdctl/blob/main/docs/testing/README.md#about-parallelization
         run: go test -p 1 -v ./cmd/nerdctl/...

.github/workflows/test-kube.yml

@@ -22,7 +22,7 @@ jobs:
         with:
           fetch-depth: 1
       - name: "Run Kubernetes integration tests"
-        # See https://github.com/containerd/nerdctl/blob/main/docs/dev/testing.md#about-parallelization
+        # See https://github.com/containerd/nerdctl/blob/main/docs/testing/README.md#about-parallelization
         run: |
           ./hack/build-integration-kubernetes.sh
           sudo ./_output/nerdctl exec nerdctl-test-control-plane bash -c -- 'export TMPDIR="$HOME"/tmp; mkdir -p "$TMPDIR"; cd /nerdctl-source; /usr/local/go/bin/go test -p 1 ./cmd/nerdctl/... -test.only-kubernetes'

.github/workflows/test.yml

@@ -290,15 +290,15 @@ jobs:
           timeout_minutes: 30
           max_attempts: 2
           retry_on: error
-          # See https://github.com/containerd/nerdctl/blob/main/docs/dev/testing.md#about-parallelization
+          # See https://github.com/containerd/nerdctl/blob/main/docs/testing/README.md#about-parallelization
           command: go test -p 1 -timeout 20m -v -exec sudo ./cmd/nerdctl/... -args -test.target=docker -test.allow-kill-daemon
       - name: "Ensure that the IPv6 integration test suite is compatible with Docker"
         uses: nick-fields/retry@v3
         with:
           timeout_minutes: 30
           max_attempts: 2
           retry_on: error
-          # See https://github.com/containerd/nerdctl/blob/main/docs/dev/testing.md#about-parallelization
+          # See https://github.com/containerd/nerdctl/blob/main/docs/testing/README.md#about-parallelization
           command: go test -p 1 -timeout 20m -v -exec sudo ./cmd/nerdctl/... -args -test.target=docker -test.allow-kill-daemon -test.only-ipv6
 
   test-integration-windows:
@@ -332,7 +332,7 @@ jobs:
         run: powershell hack/configure-windows-ci.ps1
       # TODO: Run unit tests
       - name: "Run integration tests"
-        # See https://github.com/containerd/nerdctl/blob/main/docs/dev/testing.md#about-parallelization
+        # See https://github.com/containerd/nerdctl/blob/main/docs/testing/README.md#about-parallelization
         run: go test -p 1 -v ./cmd/nerdctl/...
 
   test-integration-freebsd:

README.md

@@ -253,7 +253,7 @@ Using `go install github.com/containerd/nerdctl/v2/cmd/nerdctl` is possible, but
 
 ### Testing
 
-See [testing nerdctl](docs/dev/testing.md).
+See [testing nerdctl](docs/testing/README.md).
 
 ### Contributing to nerdctl
 

docs/dev/testing.md renamed to docs/testing/README.md

@@ -1,5 +1,10 @@
 # Testing nerdctl
 
+This document covers basic usage of nerdctl testing tasks, and generic recommendations
+and principles about writing tests.
+
+For more comprehensive information about nerdctl test tools, see [tools.md](tools.md).
+
 ## Lint
 
 ```