Update README tree and repo name

Author: cmccomb

README.md

@@ -39,6 +39,13 @@ make repro
 
 ```text
 .
+├── .github
+│   └── workflows
+│       ├── ci.yml
+│       └── docs-pages.yml
+├── .gitignore
+├── .pre-commit-config.yaml
+├── .python-version
 ├── AGENTS.md
 ├── CONTRIBUTING.md
 ├── LICENSE
@@ -60,29 +67,54 @@ make repro
 │   ├── check_docs_consistency.py
 │   └── check_google_docstrings.py
 ├── src
-│   ├── design_research_python_template
 │   └── drc_python_template
+│       ├── __init__.py
+│       ├── core.py
+│       └── py.typed
 ├── tests
 │   ├── test_core.py
 │   └── test_public_api.py
 └── uv.lock
 ```
 
-- `.github/workflows/` contains the GitHub Actions definitions for CI and docs publishing.
-- `docs/` contains the Sphinx source files for the package documentation.
-- `examples/` contains small runnable scripts that demonstrate the public API.
-- `scripts/` contains repository maintenance and validation helpers used by `make`.
-- `src/drc_python_template/` contains the installable Python package code.
+The top-level tree above is the minimum working package scaffold. Each element
+has a specific job:
+
+- `.github/` stores GitHub-specific automation and repository metadata.
+  - `.github/workflows/` contains the GitHub Actions pipelines for this repository.
+    - `.github/workflows/ci.yml` runs the main validation pipeline, centered on `make ci`.
+    - `.github/workflows/docs-pages.yml` builds the docs and publishes them to GitHub Pages.
+- `.gitignore` keeps local caches, IDE files, build outputs, and virtualenvs out of version control.
+- `.pre-commit-config.yaml` defines the optional local pre-commit hook configuration.
+- `.python-version` pins the preferred reproducible interpreter version for local setup.
+- `AGENTS.md` provides repository-specific instructions for coding agents and automation.
+- `CONTRIBUTING.md` documents the contributor workflow, quality checks, and review expectations.
+- `LICENSE` defines the repository's software license terms.
+- `Makefile` is the main command surface for setup, linting, typing, testing, docs, and release checks.
+- `README.md` is the onboarding document that explains the template and how to use it.
+- `docs/` contains the Sphinx documentation source tree.
+  - `docs/api.rst` builds the API reference from the package's Python docstrings.
+  - `docs/conf.py` configures Sphinx extensions, theme settings, and the docs build behavior.
+  - `docs/dependencies_and_extras.rst` explains the dependency model and optional extras.
+  - `docs/drc.png` is the shared DRC logo used in the generated docs site.
+  - `docs/index.rst` is the documentation landing page and toctree entry point.
+  - `docs/quickstart.rst` provides the short setup path for local development.
+- `examples/` contains small runnable examples intended to show the public API in use.
+  - `examples/README.md` explains what examples exist and how to run them.
+  - `examples/basic_usage.py` is the minimal working example for the template package.
+- `pyproject.toml` defines package metadata, dependencies, build settings, and tool configuration.
+- `scripts/` contains helper scripts used by the Make targets and local checks.
+  - `scripts/check_coverage_thresholds.py` enforces the minimum coverage percentage from the coverage report.
+  - `scripts/check_docs_consistency.py` verifies that the docs tree and package references stay in sync.
+  - `scripts/check_google_docstrings.py` checks for required module, class, and function docstrings.
+- `src/` is the source root for the `src`-layout package.
+  - `src/drc_python_template/` contains the installable Python package itself.
+    - `src/drc_python_template/__init__.py` defines the curated public import surface.
+    - `src/drc_python_template/core.py` contains the small example implementation shipped with the template.
+    - `src/drc_python_template/py.typed` marks the package as PEP 561 typed for downstream tooling.
 - `tests/` contains the pytest suite that protects the public behavior.
-- `.gitignore` defines which local caches, virtualenvs, and build outputs stay untracked.
-- `.pre-commit-config.yaml` provides an optional pre-commit hook that runs the local CI gate.
-- `.python-version` pins the preferred reproducible Python interpreter version.
-- `AGENTS.md` documents repository-specific guidance for coding agents and contributors.
-- `CONTRIBUTING.md` documents the human contributor workflow and quality checks.
-- `LICENSE` contains the repository's software license.
-- `Makefile` provides the standard local commands for setup, linting, testing, docs, and releases.
-- `README.md` is the top-level overview and quickstart guide for the repository.
-- `pyproject.toml` defines package metadata, dependencies, and tool configuration.
+  - `tests/test_core.py` tests the package's example core behavior.
+  - `tests/test_public_api.py` keeps the top-level exports explicit and stable.
 - `uv.lock` pins the reproducible dependency graph used by `make repro`.
 
 ## Customizing The Template