run: add support --no-build, --pull flags #277

	# this workflow runs the remote validate bake target from docker/docs
	# to check if yaml reference docs used in this repo are valid
	name: docs-upstream

	# Default to 'contents: read', which grants actions to read commits.
	#
	# If any permission is set, any permission not included in the list is
	# implicitly set to "none".
	#
	# see https://docs.github.com/en/actions/using-workflows/workflow-syntax-for-github-actions#permissions
	permissions:
	contents: read

	concurrency:
	group: ${{ github.workflow }}-${{ github.ref }}
	cancel-in-progress: true

	on:
	push:
	branches:
	- 'main'
	- 'v[0-9]*'
	paths:
	- '.github/workflows/docs-upstream.yml'
	- 'docs/**'
	pull_request:
	paths:
	- '.github/workflows/docs-upstream.yml'
	- 'docs/**'

	jobs:
	docs-yaml:
	runs-on: ubuntu-latest
	steps:
	-
	name: Checkout
	uses: actions/checkout@v4
	-
	name: Upload reference YAML docs
	uses: actions/upload-artifact@v4
	with:
	name: docs-yaml
	path: docs/reference
	retention-days: 1

	validate:
	uses: docker/docs/.github/workflows/validate-upstream.yml@919a9b9104a34a40b30d116529bcce589a544d1c # pin for artifact v4 support: https://github.com/docker/docs/pull/19220
	needs:
	- docs-yaml
	with:
	module-name: docker/compose

Provide feedback