Merge pull request #51 from code4policy/content-pages

Content pages notes not affecting anythign and could be removed later as necessary.

Author: Wondem-prog

WIRE_FRAMES.md

@@ -0,0 +1,124 @@
+# Wireframes v1 – Zero-Sum Thinking Interactive Website
+
+**Version:** v1.0  
+**Purpose:**  
+Text-based wireframes defining page structure, content hierarchy,
+and interpretive guardrails for the Zero-Sum Thinking website.
+
+---
+
+## Persistent Elements
+- Top navigation bar on all pages
+- Footer on all pages:
+  - Data sources
+  - Ethics & Privacy
+  - Citation information
+
+---
+
+## Page 1 – Home (Landing Page)
+**Purpose:** Orientation and entry point.
+
+- Page title
+- Short definition of zero-sum thinking
+- Why it matters for U.S. political differences
+- Primary actions:
+  - Learn the concept
+  - Explore the data
+  - Take the test
+- Static visual preview (chart or U.S. map)
+
+---
+
+## Page 2 – What Is Zero-Sum Thinking?
+**Purpose:** Conceptual understanding before data.
+
+- Core definition
+- Zero-sum vs positive-sum comparison
+- Everyday examples:
+  - Jobs
+  - Trade
+  - Immigration
+  - Income
+- Why this matters for politics
+
+---
+
+## Page 3 – Zero-Sum Thinking in the Research
+**Purpose:** Explain measurement, not results.
+
+- Research question and motivation
+- Survey-based measurement
+- Domains:
+  - Ethnic groups
+  - Trade
+  - Income groups
+  - Citizens vs non-citizens
+- Index construction (0–100)
+- Link to questionnaire/appendix
+
+---
+
+## Page 4 – Explore the Data (Dashboard)
+**Purpose:** Guided empirical exploration.
+
+Tabs:
+1. National overview
+2. Groups & differences
+3. Geography (state-level)
+4. Relationships with policy attitudes
+
+Guardrails:
+- Aggregated data only
+- No causal language
+- Framing text per tab
+
+---
+
+## Page 5 – Take the Zero-Sum Thinking Test
+**Purpose:** Engagement without diagnosis.
+
+- 4–6 Likert-scale items
+- Client-side scoring (0–100)
+- Comparison with national distribution
+- Interpretation guidance (non-diagnostic)
+- No data storage
+
+---
+
+## Page 6 – Methods & Transparency
+**Purpose:** Academic credibility.
+
+- Data sources and sample
+- Measurement and index construction
+- Aggregation and visualization logic
+- Replication materials
+- Limitations
+
+---
+
+## Page 7 – Ethics, Privacy & Disclaimer
+**Purpose:** Prevent misuse.
+
+- Privacy protections
+- Ethical framing
+- Interpretation disclaimer
+- Responsible citation
+
+---
+
+## Page 8 – References & Further Reading
+**Purpose:** Scholarly grounding.
+
+- Full citation of main publication
+- Related literature
+- Data and replication links
+
+---
+
+## Page 9 – About the Project / Team
+**Purpose:** Transparency and accountability.
+
+- Project motivation
+- Team and institutional affiliations
+- Contact or repository link

content/page1-home.md

@@ -0,0 +1,35 @@
+1. Home (Landing Page for All Users)
+PAGE 1 — HOME 
+Main Title (H1)
+Zero-Sum Thinking and U.S. Political Differences
+Subtitle (H2)
+An interactive explainer, data dashboard, and self-assessment
+________________________________________
+The Concept in Short
+Zero-sum thinking is the belief that gains for one group necessarily come at the expense of others. This belief shapes how people interpret economic change, social groups, and public policy.
+________________________________________
+Purpose
+This website translates the empirical findings of the publication “Zero-Sum Thinking and the Roots of U.S. Political Differences” by Sahil Chinoy, Nathan Nunn, Sandra Sequeira, Stefanie Stantcheva into an interactive, public-facing educational platform. It combines conceptual explanation, empirical visualization, and self-assessment, while maintaining academic rigor, transparency, and ethical safeguards.
+________________________________________
+Why Zero-Sum Thinking 
+Beliefs about gains and losses unavoidably play a central role in social and political life. Zero-sum thinking shapes how people interpret conflict and cooperation, evaluate political leaders, respond to election outcomes, and assess policies related to redistribution, immigration, trade, and social inclusion. It helps explain why similar economic or social changes can generate cooperation and trust in some settings, but fear, polarization, or conflict in others.
+Why This Study
+The research used draws on a large-scale, carefully designed survey study by established scholars in political economy and public economics. By systematically measuring zero-sum thinking and linking it to political attitudes, the study provides one of the most comprehensive empirical frameworks to date for understanding how underlying beliefs about gains and losses contribute to political disagreement, policy resistance, and broader patterns of social cohesion and conflict.
+________________________________________
+What You Can Explore on This Site [Primary Actions]
+What Is Zero-Sum Thinking? (Conceptual Explainer)
+Learn what zero-sum thinking means and how it differs from “win-win” perspectives.
+Explore the Data (Interactive Dashboard)
+Examine aggregated charts and maps showing patterns reported in the study.
+Take the Zero-Sum Thinking Test (Self-Assessment)
+Answer a short questionnaire adapted from the research and see how your responses compare with the overall distribution.
+________________________________________
+Explore the Data [Interactive Preview (Clickable)]
+Preview selected aggregated results from the study.
+Click to open the Explore the Data page.
+________________________________________
+Source & Attribution
+All findings and data summarized here are drawn from the authors’ published research and related materials. This site presents those results for educational purposes.
+________________________________________
+Transparency Note (Small Text)
+Educational use only. Aggregated data only. No personal information is stored.

content/page2-concept.md

@@ -0,0 +1,41 @@
+2. What is Zero‑Sum Thinking? (For Ordinary user principally but also for researchers and policy makers)
+PAGE 2 — WHAT IS ZERO-SUM THINKING? 
+The Idea
+Zero-sum thinking is the belief that gains for one person or group must come at the expense of others. In other words, it assumes that there is a fixed amount to be shared, and that if someone gains more, someone else must lose.
+This way of thinking is common in everyday discussions about the economy, politics, and social change.
+________________________________________
+Zero-Sum Thinking vs. Shared Gains
+Not all situations involve unavoidable trade-offs. In many cases, economic growth, cooperation, or new policies can allow multiple groups to benefit at the same time.
+•	Zero-sum thinking views outcomes as a fixed pie: one group’s gain implies another group’s loss.
+•	Shared-gains (or positive-sum) thinking allows for the possibility that the overall pie can grow, so that more than one group can benefit.
+People may apply one or the other way of thinking depending on the issue, the context, or their personal experiences.
+________________________________________
+A Simple Example: The Pie/ Pizza
+Imagine a pie shared by two groups.
+•	In zero-sum thinking, the size of the pie never changes.
+If one group gets a larger slice, the other group must get a smaller one.
+•	In shared-gains (positive-sum) thinking, the pie itself can grow.
+Both groups can end up with larger slices, even if the shares are not equal.
+This example shows why zero-sum thinking focuses on competition over fixed resources, while other perspectives allow for cooperation, growth, or mutual benefit.
+________________________________________
+Common Examples
+Zero-sum thinking often appears in debates about:
+•	Jobs: If one group gets more jobs, others must lose out.
+•	Trade: If one country benefits from trade, another country must be harmed.
+•	Immigration: Gains for immigrants reduce opportunities for citizens.
+•	Income and wealth: If some people become richer, others must become poorer.
+These beliefs shape how people interpret social and economic change, even when the actual outcomes may be more complex.
+________________________________________
+Why This Way of Thinking Matters
+How people understand gains and losses affects how they view social groups, political competition, and public policy. Zero-sum thinking can increase feelings of threat, competition, or unfairness between groups, while other perspectives may encourage cooperation or compromise.
+Understanding this mindset helps explain why people can react very differently to the same policies, events, or economic trends.
+________________________________________
+What Next 
+Now you either take the test or dive deeper into the research and see how researchers study and measure zero-sum thinking using survey questions. 
+To study zero-sum thinking, researchers have asked people a small number of carefully designed questions about gains and losses in different situations. The answers are combined into a single zero-sum thinking index, which summarizes how strongly a person tends to see outcomes as zero-sum: Higher scores indicate a stronger tendency to believe a group’s gain comes at the expense of another, while lower scores indicate greater openness to the possibility of shared gains. In other words, higher score reflects a stronger “one wins, one loses” view; lower score reflects a stronger ‘both can benefit’ view.
+•	Take the Zero-Sum Thinking Test
+Answer a short questionnaire adapted from the research and see how your responses compare.
+•	Explore the Data
+View charts and maps showing aggregated patterns from the study.
+•	Learn About the Research
+Read a more detailed explanation of how zero-sum thinking is measured and analyzed.

content/page3-research.md

@@ -0,0 +1,43 @@
+3. Zero‑Sum Thinking of the Research (For researchers and policy makers)
+PAGE 3 — ZERO-SUM THINKING OF THE RESEARCH
+Purpose of the Study
+The study “Zero-Sum Thinking and the Roots of U.S. Political Differences” investigates how beliefs about gains and losses shape political attitudes in the United States. Rather than focusing only on material interests or partisan identities, the research examines a deeper cognitive framework: whether individuals tend to see social and economic outcomes as zero-sum or as allowing for shared gains.
+The central claim is that zero-sum thinking is a measurable mindset that helps explain persistent political disagreement across a wide range of policy areas.
+________________________________________
+How Zero-Sum Thinking Is Measured
+The study measures zero-sum thinking using survey questions designed to capture respondents’ beliefs about whether gains for one group come at the expense of others.
+Respondents are asked to indicate their level of agreement with statements expressing zero-sum views across different social and economic domains. Higher agreement with these statements indicates a stronger zero-sum orientation.
+Importantly, the questions are framed in general terms and do not require respondents to endorse specific policies or political parties.
+________________________________________
+Domains Covered
+Zero-sum thinking is measured across multiple domains, including:
+•	Ethnic and social groups
+Beliefs about whether gains for one group imply losses for others.
+•	International trade
+Beliefs about whether economic gains from trade are necessarily offset by losses elsewhere.
+•	Income and economic groups
+Beliefs about whether increases in wealth for some groups require others to become worse off.
+•	Citizens and non-citizens
+Beliefs about competition over economic opportunities and resources.
+Measuring multiple domains allows the researchers to assess whether zero-sum thinking reflects a general mindset rather than issue-specific opinions.
+________________________________________
+From Survey Responses to an Index
+Individual responses are combined into a standardized zero-sum thinking index, typically scaled from low to high values. Higher scores indicate a stronger tendency to view social and economic outcomes as zero-sum.
+The index construction follows standard practices in survey research, ensuring internal consistency and comparability across respondents.
+Details on question wording, scaling, and validation are provided in the original paper and its supplementary materials.
+________________________________________
+How to Interpret the Zero-Sum Thinking Index
+The zero-sum thinking index is scaled so that higher values indicate a stronger tendency to view social and economic outcomes as zero-sum, meaning that gains for one group are perceived as coming at the expense of others. Lower values indicate a weaker zero-sum orientation and a greater openness to the possibility of shared gains.
+The index does not measure support for specific policies, political parties, or moral judgments. Instead, it captures a general belief structure about how gains and losses are understood across different contexts.
+
+Why This Approach Matters
+This measurement strategy allows researchers and policy analysts to:
+•	distinguish underlying beliefs from policy preferences,
+•	compare zero-sum thinking across demographic, social, and political groups,
+•	examine how the same mindset relates to attitudes on different policy issues,
+•	move beyond simple partisan explanations of polarization.
+By focusing on beliefs about gains and losses, the study provides a framework for understanding political disagreement that is relevant for policy design, conflict prevention, and communication strategies.
+________________________________________
+Data Transparency
+This website presents aggregated results only, based on the published study and its associated materials. Individual-level data are not displayed or stored here.
+For full methodological details, replication materials, and technical discussion, users are encouraged to consult the original publication and its appendices.

content/page4-data.md

@@ -0,0 +1,33 @@
+4. Explore the Data (Interactive Dashboard for well informed Ordinary Users as well as Researchers and Policy Makers): these are explanatory texts to be edited and the visualization and the data are to be generated in another story 
+PAGE 4 — EXPLORE THE DATA
+What You Are Seeing
+This page presents aggregated results from the survey study on zero-sum thinking. The charts and maps summarize patterns across groups and places; they do not display individual responses.
+The purpose of this page is to help users explore how zero-sum thinking varies across the population and how it relates to different social and political attitudes.
+________________________________________
+How to Read the Charts
+Each chart shows how zero-sum thinking scores are distributed or how average scores differ across groups or locations.
+As a reminder:
+Higher scores mean people are more likely to see one group’s gains as another group’s losses, while lower scores mean people are more open to the idea that different groups can gain at the same time.
+________________________________________
+Sections on This Page
+You can explore the data in several ways:
+Overall Patterns
+These charts show the overall distribution of zero-sum thinking scores across the survey sample.
+Groups and Differences
+These charts compare average scores across groups, such as education levels, income categories, or other demographic characteristics. Group averages reflect patterns, not individual beliefs.
+Geography
+Maps display average zero-sum thinking scores by geographic area. Geographic patterns reflect aggregated responses and may be influenced by many social, economic, and historical factors.
+Relationships with Attitudes
+Some charts show how zero-sum thinking is related to attitudes on selected policy issues. These relationships indicate associations, not causes.
+________________________________________
+Important Notes on Interpretation
+•	Differences shown here are statistical patterns, not judgments about individuals or groups.
+•	A higher or lower average score does not imply that everyone in a group thinks the same way.
+•	Associations shown in the charts do not mean that one belief causes another.
+These results should be read as descriptive evidence that helps illuminate broader patterns of thinking.
+________________________________________
+What You Can Do 
+•	→ Take the Zero-Sum Thinking Test
+See how your own responses compare with the overall distribution.
+•	→ Learn About the Research
+Read more about how the survey questions were designed and how the index was constructed.

content/page5-test.md

@@ -0,0 +1,36 @@
+5. Take the Zero‑Sum Thinking Test (Ordinary User and Others)
+PAGE 5 — TAKE THE ZERO-SUM THINKING TEST
+What This Test Is
+This short questionnaire is adapted from survey questions used in the research on zero-sum thinking. It asks about how people view gains and losses in different situations.
+The test is designed to help you understand how your responses compare with overall patterns observed in the study.
+________________________________________
+Before You Begin
+•	There are a small number of statements.
+•	There are no right or wrong answers.
+•	Your responses are not stored and are processed only to calculate your score.
+Please answer based on how you generally think, not how you think you “should” answer.
+________________________________________
+After You See Your Score
+Your result is summarized using the zero-sum thinking index.
+As a reminder:
+Higher scores mean people are more likely to see one group’s gains as another group’s losses, while lower scores mean people are more open to the idea that different groups can gain at the same time.
+Your score reflects tendencies, not fixed traits, and it may vary across contexts or over time.
+________________________________________
+How to Read Your Result
+•	The score shows where your responses fall relative to the overall distribution reported in the study.
+•	Being higher or lower on the scale does not indicate that a view is right or wrong.
+•	People with similar scores may still disagree strongly on specific policies or issues.
+This tool is meant to encourage reflection, not to label individuals.
+________________________________________
+Important Notes
+•	This test does not diagnose beliefs, values, or political identity.
+•	It does not predict behavior or voting.
+•	It is intended for educational use only.
+________________________________________
+What You Can Do Next
+•	→ Explore the Data
+See how scores vary across groups and locations in aggregated form.
+•	→ Learn About the Research
+Read how the survey questions were designed and how the index was constructed.
+•	→ Return to the Concept
+Review the explanation of zero-sum thinking and the pie example.