build: namespace make targets with / separator

Group related targets under a common namespace for discoverability:

- docs           -> docs/build
- (new)          -> docs/lint
- (new)          -> docs/format
- test           -> test/pyathena
- test-sqla      -> test/sqla
- test-sqla-async-> test/sqla-async

Propagate the rename through pyproject.toml (tox commands), CLAUDE.md,
docs/testing.md, and the docs/docs-lint GitHub workflows.

Co-Authored-By: Claude Opus 4.7 <noreply@anthropic.com>

Author: laughingman7743

.github/workflows/docs-lint.yaml

@@ -19,7 +19,7 @@ jobs:
     steps:
       - uses: actions/checkout@de0fac2e4500dabe0009e67214ff5f5447ce83dd # v6.0.2
       - uses: jdx/mise-action@1648a7812b9aeae629881980618f079932869151 # v4.0.1
-      - run: make docs-lint
+      - run: make docs/lint
 
   build:
     runs-on: ubuntu-latest
@@ -33,4 +33,4 @@ jobs:
           enable-cache: true
       - run: |
           uv sync --group dev
-          make docs
+          make docs/build

.github/workflows/docs.yaml

@@ -32,7 +32,7 @@ jobs:
           enable-cache: true
       - run: |
           uv sync --group dev
-          make docs
+          make docs/build
       - name: Upload artifact
         uses: actions/upload-pages-artifact@7b1f4a764d45c48632c6b24a0339c27f5614fb0b # v4.0.0
         with:

CLAUDE.md

@@ -28,8 +28,9 @@ make lint   # Lint + format check + mypy
 
 ```bash
 # ALWAYS run `make lint` first — tests will fail if lint doesn't pass
-make test       # Unit tests (runs chk first)
-make test-sqla  # SQLAlchemy dialect tests
+make test/pyathena    # Unit tests (runs lint first)
+make test/sqla        # SQLAlchemy dialect tests
+make test/sqla-async  # SQLAlchemy async dialect tests
 ```
 
 Tests require AWS environment variables. Use a `.env` file (gitignored):
@@ -73,8 +74,9 @@ export $(cat .env | xargs) && uv run pytest tests/pyathena/test_file.py -v
 
 ```bash
 mise install          # one-time: installs markdownlint-cli2
-make docs-lint        # check
-make docs-lint-fix    # auto-fix what's possible
+make docs/lint        # check
+make docs/format      # auto-fix what's possible
+make docs/build       # build the Sphinx site under docs/_build/html
 ```
 
 ## Architecture — Key Design Decisions

Makefile

@@ -13,35 +13,35 @@ lint:
 	uvx ruff@$(RUFF_VERSION) format --check .
 	uv run mypy .
 
-.PHONY: test
-test: lint
+.PHONY: test/pyathena
+test/pyathena: lint
 	uv run pytest -n 8 --cov pyathena --cov-report html --cov-report term tests/pyathena/
 
-.PHONY: test-sqla
-test-sqla:
+.PHONY: test/sqla
+test/sqla:
 	uv run pytest -n 8 --cov pyathena --cov-report html --cov-report term tests/sqlalchemy/
 
-.PHONY: test-sqla-async
-test-sqla-async:
+.PHONY: test/sqla-async
+test/sqla-async:
 	uv run pytest -n 8 --cov pyathena --cov-report html --cov-report term tests/sqlalchemy/ --dburi async
 
 .PHONY: tox
 tox:
 	uvx tox@$(TOX_VERSION) -c pyproject.toml run
 
-.PHONY: docs
-docs:
+.PHONY: docs/build
+docs/build:
 	uv run sphinx-multiversion docs docs/_build/html
 	echo '<meta http-equiv="refresh" content="0; url=./master/index.html">' > docs/_build/html/index.html
 	echo 'pyathena.dev' > docs/_build/html/CNAME
 	touch docs/_build/html/.nojekyll
 
-.PHONY: docs-lint
-docs-lint:
+.PHONY: docs/lint
+docs/lint:
 	mise exec -- markdownlint-cli2
 
-.PHONY: docs-lint-fix
-docs-lint-fix:
+.PHONY: docs/format
+docs/format:
 	mise exec -- markdownlint-cli2 --fix
 
 .PHONY: tool

docs/testing.md

@@ -33,8 +33,9 @@ $ export AWS_ATHENA_MANAGED_WORKGROUP=pyathena-managed
 
 ```bash
 $ pip install uv or pipx install uv or brew install uv or mise install uv
-$ make test
-$ make test-sqla
+$ make test/pyathena
+$ make test/sqla
+$ make test/sqla-async
 ```
 
 ## Run test multiple Python versions

pyproject.toml

@@ -226,9 +226,9 @@ allowlist_externals =
     make
 commands =
     uv sync --group dev
-    pyathena: make test
-    sqla: make test-sqla
-    sqla_async: make test-sqla-async
+    pyathena: make test/pyathena
+    sqla: make test/sqla
+    sqla_async: make test/sqla-async
 passenv =
     TOXENV
     AWS_*