auth: update AuthN/AuthZ documentation #32

	name: Lint and validate OpenAPI specs

	on:
	- push
	- pull_request

	jobs:

	lint:
	name: Lint OpenAPI definition
	runs-on: ubuntu-latest
	steps:
	- name: Check out head branch
	uses: actions/checkout@v2
	- name: Run OpenAPI Lint Action
	uses: nwestfall/[email protected]
	with:
	github_token: ${{ secrets.GITHUB_TOKEN }}
	file: openapi/task_execution_service.openapi.yaml

	diff:
	name: Show OpenAPI differences relative to target branch
	runs-on: ubuntu-latest
	if: ${{ github.event_name == 'pull_request' }}
	steps:
	- name: Check out head branch
	uses: actions/checkout@v2
	with:
	ref: ${{ github.head_ref }}
	path: head
	- name: Check out base branch
	uses: actions/checkout@v2
	with:
	ref: ${{ github.base_ref }}
	path: base
	- name: Run OpenAPI Diff Action
	uses: mvegter/[email protected]
	with:
	head-spec: head/openapi/task_execution_service.openapi.yaml
	base-spec: base/openapi/task_execution_service.openapi.yaml

	validate:
	name: Validate OpenAPI definition
	runs-on: ubuntu-latest
	steps:
	- name: Check out head branch
	uses: actions/checkout@v2
	- name: Run OpenAPI Validate Action
	uses: char0n/swagger-editor-validate@v1
	with:
	definition-file: openapi/task_execution_service.openapi.yaml

Provide feedback