docs: normalize README structure #13

	name: CI

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

	jobs:
	lint:
	runs-on: ubuntu-latest
	steps:
	- uses: actions/checkout@v4
	- name: Set up Python
	uses: actions/setup-python@v5
	with:
	python-version: "3.14"
	cache: "pip"
	- name: Install dependencies
	run: \|
	python -m pip install --upgrade pip
	pip install poetry
	poetry install
	- name: Run Ruff
	run: poetry run ruff check .

	test:
	runs-on: ubuntu-latest
	strategy:
	matrix:
	python-version: ["3.9", "3.10", "3.11", "3.12", "3.13", "3.14"]

	services:
	altertable:
	image: ghcr.io/altertable-ai/altertable-mock:latest
	ports:
	- 15001:15001
	env:
	ALTERTABLE_MOCK_API_KEYS: test_pk_abc123
	options: >-
	--health-cmd "exit 0"
	--health-interval 5s
	--health-timeout 3s
	--health-retries 3
	--health-start-period 10s

	steps:
	- uses: actions/checkout@v4
	with:
	submodules: recursive

	- name: Set up Python
	uses: actions/setup-python@v5
	with:
	python-version: ${{ matrix.python-version }}
	cache: "pip"

	- name: Install dependencies
	run: \|
	python -m pip install --upgrade pip
	pip install poetry
	poetry install

	- name: Run tests
	run: poetry run pytest

	typing:
	name: "Typing"
	runs-on: ubuntu-latest
	steps:
	- uses: actions/checkout@v4
	- name: Set up Python
	uses: actions/setup-python@v5
	with:
	python-version: "3.14"
	cache: "pip"
	- name: Install dependencies
	run: \|
	python -m pip install --upgrade pip
	pip install poetry
	poetry install
	- name: Typecheck with mypy
	run: poetry run mypy src tests

Provide feedback