Title Card: Creator: Parisa Setayesh | Level: Beginner–Intermediate | Category: Data: Data, Space and Place
Why this matters
NYC Open Data is remarkably direct about documentation: data dictionaries should be a key resource, and the primer page contains information such as update date and field definitions. Their metadata guidance also emphasizes making documentation more usable and web-friendly. In other words, reading the documentation is not optional housekeeping — it is part of interpreting the data responsibly.
Key ideas
- Dataset pages are interpretive resources.
- “Last updated” matters.
- Field definitions matter.
- Fit matters: a dataset can be real and still be wrong for your question.
Lesson
This lesson should teach learners to slow down before they map. Who produced the data? How often is it updated? What does each field actually mean? At what geographic scale was it collected? Are there known limitations or missing values? These questions help users evaluate not just whether a dataset is available, but whether it is suitable. That is especially important for public-facing maps, where visual confidence can mask underlying ambiguity.
This is also a good bridge between data literacy and critical literacy. A map can look polished while resting on categories the viewer does not understand or on documentation the mapmaker never read. Teaching beginners to consult metadata is one of the best ways to keep mapping grounded and accountable.
Example Project or GCDI resource
Finding Data for Mapping: Tips and Tricks is a strong GCDI resource to return to here, because it positions data-finding as part of the learning process itself rather than as something invisible or trivial.
Open reading / resource
Use NYC Open Data: How To and the Metadata for All Guide. Together they reinforce the idea that data dictionaries, documentation, and clear dataset description are core parts of public data literacy.
Reflection / mini activity
Pick one NYC Open Data dataset. Spend five minutes on the primer page and write down:
- last updated date
- unit of analysis
- one field definition you needed to look up
- one possible limitation or ambiguity
Then explain whether you would trust yourself to map it yet.


0 responses to “Reading Dataset Documentation Before You Map”