Merge pull request #218 from BuildCanada/add-methodology

Add methodology to Ontario, Toronto, Vancouver Spends. Also add credits.

Author: melkuo

data/alberta/summary.json

@@ -226,5 +226,6 @@
       "percentageFormatted": "6.1%"
     }
   ],
+  "credits": "Built by [Sathvik](https://www.linkedin.com/in/sathvik-divili/)",
   "generatedAt": "2025-08-04T00:00:00.000Z"
 }

data/british-columbia/summary.json

@@ -286,5 +286,6 @@
       "percentageFormatted": "0.0%",
       "totalSpendingFormatted": "$0.0B"
     }
-  ]
+  ],
+  "credits": "Built by [Sahib](https://www.linkedin.com/in/sahib-k-b9a047156/)"
 }

data/ontario/summary.json

@@ -274,5 +274,7 @@
       "percentageFormatted": "0.0%"
     }
   ],
+  "methodology": "Top-level figures are taken from the [Annual Report](https://www.ontario.ca/page/public-accounts-2023-24-annual-report), which is independetly audited by a third-party. Granular spending data is based off of [Ministry Statements and Schedules](https://www.ontario.ca/page/public-accounts-ontario-2023-24#section-3).\n\nIn cases where the Ministry's total expenses did not sum up to the audited totals, an \"Unreported\" line-item was added ([see here](https://docs.google.com/spreadsheets/d/13IXbEx_Lu9FxYSOZkM9BHzHDICauj3TyRXfiGQHHnTU/edit?gid=1120240224#gid=1120240224)).",
+  "credits": "Built by [Jesse](https://www.linkedin.com/in/jesseleecan/)",
   "generatedAt": "2025-06-23T08:00:06.275Z"
 }

data/toronto/summary.json

@@ -89,5 +89,7 @@
       "percentageFormatted": "1.4%"
     }
   ],
+  "methodology": "This diagram is based off of the City's Statement of Operations, which can be interpreted as what the City brought in (revenues) and spent (expenses) during the year.\n\nThese are sourced from the [Consolidated Financial Statements](https://www.toronto.ca/wp-content/uploads/2025/07/97e1-2024-Consolidated-Financial-Statements-07-29-2025.pdf), which is audited by an independent third-party, and [Revenues and Expenses Datasheet](https://open.toronto.ca/dataset/revenues-and-expenses/). The former offered more granular data on the revenue side, while the latter offered more granular data on the expense side.\n\nIn cases where there were discrepancies between the audited totals and the sums of the granular data, the audited totals was used as the source of truth, and an \"Unreported\" line-item was added to ensure totals matched.",
+  "credits": "Built by [Ajay](https://www.linkedin.com/in/ajay-matharoo/), [Jonathan](https://www.linkedin.com/in/jonathan-talmi-1a099852/), and [Je Ho](https://www.linkedin.com/in/je-ho-cho-194115198/)",
   "generatedAt": "2025-10-21T22:57:13Z"
 }

data/vancouver/summary.json

@@ -88,5 +88,7 @@
       "percentage": 2.164089,
       "percentageFormatted": "2.16%"
     }
-  ]
+  ],
+  "methodology": "This diagram is based off of the City's Statement of Operations, which can be interpreted as what the City brought in (revenues) and spent (expenses) during the year.\n\nData is sourced from Vancouver's [Annual Financial Report](https://vancouver.ca/files/cov/2024-annual-financial-report.pdf). Taxes collected by the City on behalf of other authorities have been included in the diagram (see Note 15(g) in the Report). Expenses for tangible capital assets have been included as well (see Note 13 in the Report). Full worksheet [here](https://docs.google.com/spreadsheets/d/1_ZBTlhPj9aCwj5lxCkX3EKZxm4DNQPun).",
+  "credits": "Built by [Boris](https://www.linkedin.com/in/boris-tsao-asa-8499b91b/)"
 }

src/app/[lang]/(main)/[jurisdiction]/page.tsx

@@ -393,6 +393,32 @@ export default async function ProvinceIndex({
             />
           </Section>
         )}
+        {jurisdiction.methodology && (
+          <Section>
+            <H2>
+              <Trans>Methodology</Trans>
+            </H2>
+            {jurisdiction.methodology.split("\n\n").map((paragraph, index) => (
+              <P key={index}>
+                {paragraph.match(/\*\*([^*]+)\*\*/) ||
+                paragraph.match(/\[([^\]]+)\]\(([^)]+)\)/) ? (
+                  <span
+                    dangerouslySetInnerHTML={{
+                      __html: paragraph
+                        .replace(/\*\*([^*]+)\*\*/g, "<strong>$1</strong>")
+                        .replace(
+                          /\[([^\]]+)\]\(([^)]+)\)/g,
+                          '<a href="$2" class="text-blue-500 underline hover:text-blue-600" target="_blank" rel="noopener noreferrer">$1</a>',
+                        ),
+                    }}
+                  />
+                ) : (
+                  <Trans>{paragraph}</Trans>
+                )}
+              </P>
+            ))}
+          </Section>
+        )}
         <Section>
           <H2>
             <Trans>Sources</Trans>
@@ -409,6 +435,30 @@ export default async function ProvinceIndex({
             </Trans>
           </P>
         </Section>
+        {jurisdiction.credits && (
+          <Section className="text-center text-sm">
+            <hr className="my-8"></hr>
+            {jurisdiction.credits.split("\n\n").map((paragraph, index) => (
+              <P key={index}>
+                {paragraph.match(/\*\*([^*]+)\*\*/) ||
+                paragraph.match(/\[([^\]]+)\]\(([^)]+)\)/) ? (
+                  <span
+                    dangerouslySetInnerHTML={{
+                      __html: paragraph
+                        .replace(/\*\*([^*]+)\*\*/g, "<strong>$1</strong>")
+                        .replace(
+                          /\[([^\]]+)\]\(([^)]+)\)/g,
+                          '<a href="$2" class="text-blue-500 underline hover:text-blue-600" target="_blank" rel="noopener noreferrer">$1</a>',
+                        ),
+                    }}
+                  />
+                ) : (
+                  <Trans>{paragraph}</Trans>
+                )}
+              </P>
+            ))}
+          </Section>
+        )}
       </PageContent>
     </Page>
   );

src/lib/jurisdictions.ts

@@ -13,11 +13,12 @@ export type Jurisdiction = {
   totalProvincialSpending: number;
   total: number;
   source: string;
-  // Optional list of ministries from summary.json; used for fallback counts
   ministries?: unknown[];
   debtInterest: number;
   netDebt: number;
   totalDebt: number;
+  methodology?: string;
+  credits?: string;
 };
 
 type Category = {