About

How Chicago Explainer works

How it was built, our approach, how we handle data, how we correct mistakes and how to reach us.

Last updated November 19, 2026

How it was built

Chicago Explainer was built by Matt Moog as a passion project to create a civic information resource for Chicago-area residents. AI was used to search for and gather public data and research, build the charts, maps and data tables, draft plain-language summaries of reports and articles, draft the arguments for and against each idea, summarize the studies behind each evidence panel, and write the code that runs the site. Without AI, a project of this size would require a staff and a budget that this initial version does not have.

The judgment behind the site is Matt’s. With input from experts, he chose the issues, the metrics and the ideas to feature, set the rules for fair comparisons and balance, and reviewed the work and made countless revisions to improve quality, clarity, consistency and balance. He also shaped how the site looks and reads, from its design and charts to the tone of each page.

What you see today is the initial version, and it will change quickly as more people contribute. The purpose is to provide context and create a platform for civic dialogue grounded in facts and ideas. Much of the best thinking about Chicago’s future already exists in research from universities and civic organizations, in public data, and in reporting from Chicago’s newsrooms. Chicago Explainer brings that work together in one place, gives it a fair hearing and sends readers to the original.

1,641
citations, each linked to the original
344
publishers and agencies whose work we draw on
169
research reports, plans and long-form articles in the Library
104
issue metrics tracked over time

Here is how the decisions are made and the work is checked.

  • Editorial decisions. We sought input from experts to determine what issues we should focus on, what metrics should be featured and what ideas should be featured. It is our expectation that over time, with the input of the community, each one of those decisions will evolve. A few rules apply throughout: use the same source and definition for every city in a comparison, and drop a measure when reliable data does not exist rather than fill the gap.
  • Fairness and evidence. We have done our best to present a full set of facts in a fair way, with arguments for and against each idea. Each idea also has an evidence panel that rates the quality of the research behind it, how widely it has been tested and whether it has been tried in Chicago, with a link to each study.
  • Sourcing. We work to ensure the quality of the data by providing a source link for every piece of data, and we ask experts to review the data and sources. Every figure, chart and table names its source and links to the original. The site has 1,641 citations from 344 publishers and agencies, and the Sources and Citations pages list every one. We rely on public data from agencies such as the Census Bureau and the Bureau of Labor Statistics, research from organizations such as the Civic Federation, and reporting from Chicago’s newsrooms.
  • Expert review. Academics, policy professionals and civic leaders are being invited to review the issues in their areas of expertise. That review is ongoing.
  • Contributors. The site will be shaped by the people who know these issues best. We invite academic experts, policy professionals, elected officials and community members with good ideas and lived experience to review content, share ideas and contribute their own work. Contributors are credited on the page where their work appears.
  • Reader feedback. Readers can report an error through the Contribute form, and corrections are dated and explained at the bottom of the page. Readers can also submit and vote on ideas, and each month we review the top-voted ideas for the issue pages.
AI tools can make mistakes, and so can people. The answer in both cases is to show the sources, invite scrutiny and fix errors in the open. If you find something wrong, or have an idea or expertise to share, please tell us.

Our approach

Chicago Explainer lays out the city’s biggest issues with data, the main policy ideas and the strongest case for and against each one. We do not endorse candidates, parties or ballot measures, and we do not tell readers what to conclude.

  • Data first. Every issue opens with long-run trends from public sources, and Chicago is compared with the nation’s largest cities and metros where comparable data exists.
  • Both sides. Each policy idea shows its strongest supporting and opposing arguments, who makes them and what each would cost.
  • Reader-driven. Readers post and vote on ideas for solving the issues. Each month we review the top-voted ideas and consider them for the issue pages.

Methodology

We use the most recent year available from each source and say when a figure is preliminary. Dollar amounts over time are adjusted for inflation when a chart says so. Comparisons with other cities use the same source and definition for every city; when no comparable source exists, we say so instead of mixing definitions.

  • Peer cities: the 10 largest U.S. cities by population, or the 10 largest metro areas when the data is regional.
  • Rankings: “1st” is always the highest value. Whether higher is better depends on the measure, and each chart says which.
  • Sources: every fact links to its source, and the full list is on the Citations page.

Corrections

When we get something wrong, we fix it and add a dated correction note at the bottom of the page that explains what changed. Small fixes such as typos are made without a note. To report an error, use the Contribute form and choose “Report an error.” Include the page and, if you can, the correct figure and its source.

Independence

Chicago Explainer does not run ads and does not accept money that comes with editorial conditions. Organizations listed on our Sources page are where our data and research come from; listing them does not mean they endorse us or that we endorse them.

Contributors

Chicago Explainer is an independent project based in Chicago. Every figure is checked against its source before it is published, and readers can flag anything we missed. Readers whose essays, research or data we publish are credited on the page where their work appears.

Contact

Send story tips, data, corrections and partnership questions through the Contribute form. We read every message.

See also the privacy policy and terms of use.