docs: chiarisce ruolo e flusso canonico del toolkit

[matteocavo]

Refs dataciviclab/lab-ops#60

Sintesi

Riallinea la documentazione del toolkit al flusso canonico del Lab, chiarendo meglio:

• il ruolo del toolkit nell'ecosistema DataCivicLab
• il confine tra percorso canonico, tooling advanced e superfici experimental / compatibility
• i comandi CLI da usare davvero nei quickstart e nei check di publish

Cosa cambia

README

• rende il quickstart più diretto e leggibile in apertura
• chiarisce che il toolkit è il motore tecnico, non l'hub dell'organizzazione
• esplicita meglio il workflow canonico per i repo dataset
• mantiene inspect paths, schema-diff, cross_year e i rerun parziali nel giusto perimetro

Documentazione tecnica

• aggiunge docs/conventions.md come pagina di contratto operativo più chiara e centralizzata
• aggiorna docs/publish_check.md sui comandi CLI canonici post-install (toolkit ...)
• aggiorna docs/runtime-boundaries.md per distinguere meglio:
  • core runtime
  • advanced tooling
  • experimental (scout-url)
  • compatibility only
• aggiunge scout_url alla matrice in docs/feature-stability.md

Test collection

• rimuove da tests/conftest.py il riferimento a test_deprecated_shims.py, file che non esiste nel repo

Perché

Nel refactor UX cross-repo il toolkit deve presentarsi in modo coerente con il resto dell'ecosistema:

• repo tecnica del motore
• contratto stabile per runtime / config / output
• docs che non confondono il percorso canonico con strumenti di recovery o diagnostica

Questa PR fa soprattutto pulizia di framing e riduce alcune ambiguità residue nella docs del toolkit.

Verifica

Verificato localmente che:

• la suite completa passa: 199 passed
• il branch non introduce modifiche runtime oltre al cleanup del marker compat in tests/conftest.py
• i comandi documentati in README.md e docs/publish_check.md sono coerenti con il CLI canonico toolkit

Comando usato:

• ./.venv/Scripts/python.exe -m pytest -q

Tipo

DOCS

[Gabrymi93]

CI verde su tutti i check (Ubuntu + Windows, Python 3.10 e 3.11). Docs-only, zero tocchi al runtime. Scope rispettato: README piu' diretto, conventions.md centralizzato, publish_check.md allineato ai comandi CLI canonici, runtime-boundaries.md con distinzione core/advanced/experimental/compat, conftest.py pulito da riferimento a file mai esistito. Coerente con il refactor cross-repo.