docs: clarify self-defining usersets #309

	name: review
	on:
	pull_request:
	branches:
	- main
	- feat/abac

	permissions:
	contents: read

	jobs:
	build:
	runs-on: ubuntu-latest
	steps:
	- uses: actions/checkout@b4ffde65f46336ab88eb53be808477a3936bae11 # v4.1.1
	with:
	fetch-depth: 0
	- uses: bufbuild/buf-setup-action@88db93f5d74ffa329bb43e42aa95cd822697d214 # v1.29.0
	with:
	version: "1.28.1"
	- uses: bufbuild/buf-lint-action@044d13acb1f155179c606aaa2e53aea304d22058 # v1.1.0
	- uses: bufbuild/buf-breaking-action@a074e988ee34efcd4927079e79c611f428354c01 # v1.1.3
	with:
	# The 'main' branch of the GitHub repository that defines the module.
	against: "https://github.com/${GITHUB_REPOSITORY}.git#branch=${GITHUB_BASE_REF}"
	- run: buf format -d --exit-code

	diff-openapi:
	runs-on: ubuntu-latest
	steps:
	- uses: actions/checkout@b4ffde65f46336ab88eb53be808477a3936bae11 # v4.1.1
	with:
	fetch-depth: 0
	- uses: bufbuild/buf-setup-action@88db93f5d74ffa329bb43e42aa95cd822697d214 # v1.29.0
	with:
	version: "1.28.1"
	- name: "Generate OpenAPI & Diff"
	run: \|
	./buf.gen.yaml
	./scripts/update_swagger.sh docs/openapiv2/apidocs.swagger.json
	git diff --text --exit-code docs/openapiv2/apidocs.swagger.json

	validate-openapi:
	runs-on: ubuntu-latest
	steps:
	- uses: actions/checkout@b4ffde65f46336ab88eb53be808477a3936bae11 # v4.1.1
	with:
	fetch-depth: 0
	- uses: char0n/swagger-editor-validate@65266f9d3147e446b96af879fd317ce6079529ea # v1.3.2
	with:
	definition-file: ./docs/openapiv2/apidocs.swagger.json

Provide feedback