docs: comprehensive developer experience improvements (issue #68) #4

	name: CI - Docs validation

	on:
	push:
	branches: [ main ]
	pull_request:
	branches: [ main ]

	jobs:
	validate:
	runs-on: ubuntu-latest
	steps:
	- uses: actions/checkout@v4
	- name: Set up Python (for some tools if needed)
	uses: actions/setup-python@v4
	with:
	python-version: '3.10'
	- name: Install dependencies
	run: \|
	sudo apt-get update
	sudo apt-get install -y curl shellcheck protobuf-compiler
	# Install docker-compose via pip as docker-compose-plugin isn't available on all Ubuntu versions
	python3 -m pip install --user docker-compose
	- name: Run validation
	run: \|
	make validate
	make shellcheck

Provide feedback