Suggested clarification to whiteouts #428

	name: Render and Lint Documentation

	on:
	pull_request:
	branches_ignore: []

	jobs:
	build:
	runs-on: ubuntu-latest
	strategy:
	matrix:
	# current Go releases plus the version in the go.mod are tested
	go: ['1.18', '1.22', '1.23']

	env:
	RELEASE_GO_VER: "1.23"

	name: Documentation and Linting
	steps:

	- uses: actions/checkout@v4
	with:
	path: go/src/github.com/opencontainers/image-spec

	- uses: actions/setup-go@v5
	with:
	go-version: ${{ matrix.go }}

	- name: Render and Lint
	env:
	GOPATH: /home/runner/work/image-spec/image-spec/go
	# do not automatically upgrade go to a different version: https://go.dev/doc/toolchain
	GOTOOLCHAIN: local
	run: \|
	export PATH=$GOPATH/bin:$PATH
	cd go/src/github.com/opencontainers/image-spec
	make install.tools
	go get -t -d ./...
	ls ../
	make
	make .gitvalidation
	make lint
	make check-license
	make test
	make docs

	- name: documentation artifacts
	uses: actions/upload-artifact@v4
	if: matrix.go == env.RELEASE_GO_VER
	with:
	name: oci-docs
	path: go/src/github.com/opencontainers/image-spec/output

Provide feedback