docs: add final process book pdf and README checklist

Author: Oussama

README.md

@@ -10,6 +10,19 @@ Live site: https://com-480-data-visualization.github.io/DArts/
 
 MoMA is often experienced through a small set of famous paintings and sculptures. The recorded collection tells a different story: paper works dominate the archive, a small group of countries accounts for most credited works, gender parity arrives late and unevenly, and representation varies strongly by medium. DArts turns those patterns into a martini-glass narrative: authored scenes first, an open medium explorer next, and a personal underrepresented-artist match at the end.
 
+## Intended Usage
+
+Open the live site and scroll from top to bottom. Scenes 1-3 introduce the core findings, Scene 4 lets users filter by decade, department, region, and selected country, and Scene 5 returns a deterministic underrepresented-artist match. The global decade slider filters the globe, gender chart, and medium explorer; clicking a country on the globe links that selection into later scenes.
+
+## Deliverables
+
+- Website source: [`website/`](website/)
+- Process book PDF: [`process_book.pdf`](process_book.pdf)
+- Process book LaTeX source: [`process_book/main.tex`](process_book/main.tex)
+- EDA notebook: [`notebooks/exploratory_analysis.ipynb`](notebooks/exploratory_analysis.ipynb)
+- Data aggregation script: [`data/build_aggregates.py`](data/build_aggregates.py)
+- Deployment workflow: [`.github/workflows/deploy.yml`](.github/workflows/deploy.yml)
+
 ## Team
 
 | Student | SCIPER |
@@ -26,15 +39,24 @@ MoMA is often experienced through a small set of famous paintings and sculptures
 - Python + pandas for build-time data aggregation
 - GitHub Pages deployment through GitHub Actions
 
-## Local Development
+## Technical Setup
+
+Clone with submodules so the raw MoMA data is available:
+
+```bash
+git clone --recurse-submodules https://github.com/com-480-data-visualization/DArts.git
+cd DArts
+```
+
+Install and run the website locally:
 
 ```bash
 cd website
 npm install
 npm run dev
 ```
 
-Production build:
+Run production checks:
 
 ```bash
 cd website
@@ -43,7 +65,7 @@ npm run build
 npm run preview
 ```
 
-Regenerate data aggregates:
+Regenerate data aggregates from the repository root:
 
 ```bash
 python data/build_aggregates.py
@@ -55,7 +77,7 @@ The Vite base path is `/DArts/`, matching the GitHub Pages deployment URL.
 
 Source: [Museum of Modern Art Collection](https://github.com/MuseumofModernArt/collection), public dataset.
 
-The raw MoMA files are tracked as the `data/moma-collection` submodule. `data/build_aggregates.py` reads the raw CSVs and writes compact JSON files to `website/public/data/`.
+The raw MoMA files are provided through the `data/moma-collection` Git submodule. Some upstream raw files are larger than 50 MB, so they remain in the submodule rather than being duplicated into the website bundle. The deployed site uses compact JSON aggregates in `website/public/data/`.
 
 Current reconciliation from `data/build_report.txt`:
 
@@ -72,26 +94,30 @@ The website never fetches raw CSVs at runtime. It uses pre-aggregated JSON, and
 
 ```text
 .
-├─ data/
-│  ├─ build_aggregates.py
-│  ├─ build_report.txt
-│  ├─ nationality_to_iso3.json
-│  ├─ regions.json
-│  └─ moma-collection/
-├─ notebooks/
-│  └─ exploratory_analysis.ipynb
-├─ website/
-│  ├─ public/data/
-│  ├─ public/topology/world-110m.json
-│  ├─ src/App.svelte
-│  └─ src/lib/
-│     ├─ charts/
-│     ├─ components/
-│     ├─ design/
-│     ├─ scenes/
-│     ├─ stores/
-│     └─ utils/
-└─ .github/workflows/deploy.yml
+|-- data/
+|   |-- build_aggregates.py
+|   |-- build_report.txt
+|   |-- nationality_to_iso3.json
+|   |-- regions.json
+|   `-- moma-collection/
+|-- notebooks/
+|   `-- exploratory_analysis.ipynb
+|-- process_book/
+|   |-- main.tex
+|   `-- figures/
+|-- process_book.pdf
+|-- website/
+|   |-- public/data/
+|   |-- public/topology/world-110m.json
+|   |-- src/App.svelte
+|   `-- src/lib/
+|       |-- charts/
+|       |-- components/
+|       |-- design/
+|       |-- scenes/
+|       |-- stores/
+|       `-- utils/
+`-- .github/workflows/deploy.yml
 ```
 
 ## Narrative Scenes
@@ -112,4 +138,4 @@ The workflow installs dependencies with Node 20, runs lint, builds `website/dist
 
 ## Notes
 
-This project analyzes the recorded MoMA collection metadata. Demographic fields are limited to what MoMA records; absence in the data is not a judgment of curatorial intent or of an artist's significance.
+This project analyzes the recorded MoMA collection metadata. Demographic fields are limited to what MoMA records; absence in the data is not a judgment of curatorial intent or of an artist's significance. Artwork images are not embedded; the site links out to MoMA records where available.