F-035: Neighborhood FAQ Sections

Status: Done · Priority: P1 · Updated: Mar 11, 2026

Summary

Add structured FAQ sections to neighborhood detail pages. Each neighborhood gets a set of common questions and answers — average rent, transit options, vibe, safety, grocery stores, parks, schools, etc. Great for SEO (FAQ structured data / rich snippets) and genuinely useful for people researching where to live.

Requirements

• [ ] FAQ data model — store Q&A pairs per neighborhood (bilingual)
• [ ] FAQ section on neighborhood detail page (/neighborhoods/:slug)
• [ ] Collapsible accordion UI (expand/collapse individual questions)
• [ ] FAQ structured data (FAQPage JSON-LD) for Google rich snippets
• [ ] Bilingual (FR/EN)
• [ ] Admin interface to manage FAQ entries per neighborhood

Design Ideas

Data Storage Options

Option A: Database table

• neighborhood_faqs table: id, neighborhood_id, question_en, question_fr, answer_en, answer_fr, sort_order
• Pros: admin-editable, per-neighborhood customization
• Cons: more infrastructure

Option B: Markdown in neighborhood record

• Add faq_en / faq_fr markdown fields to neighborhoods table
• Parse structured Q&A from markdown (e.g., ## Question\nAnswer)
• Pros: simpler, leverages existing markdown rendering
• Cons: harder to generate structured data

Option C: Static JSON/content

• Template-based FAQs with dynamic data interpolation
• e.g., "What is the average rent in {neighborhood}?" → auto-filled from stats
• Some questions universal, some neighborhood-specific
• Pros: low effort, auto-generates from existing data
• Cons: less unique content per neighborhood

Suggested FAQ Topics

Universal (template-based, auto-filled from data):

• What is the average rent in {neighborhood}?
• How many rental listings are available in {neighborhood}?
• What types of apartments are available?
• What is the walkability score?
• What metro stations are nearby?

Neighborhood-specific (manual content):

• What is {neighborhood} known for?
• Is {neighborhood} safe?
• What are the best restaurants/cafes?
• Are there parks and green spaces?
• How is parking?
• What schools are nearby?

UI

• Accordion component on neighborhood detail page, below description/highlights
• Each question clickable to expand/collapse answer
• "Show all" / "Collapse all" toggle
• Smooth animation

SEO

{
  "@context": "https://schema.org",
  "@type": "FAQPage",
  "mainEntity": [
    {
      "@type": "Question",
      "name": "What is the average rent in Plateau Mont-Royal?",
      "acceptedAnswer": {
        "@type": "Answer",
        "text": "The average rent in Plateau Mont-Royal is $1,650/month..."
      }
    }
  ]
}

Discussion Notes

Mar 10, 2026 — Created. FAQ sections would live on existing neighborhood detail pages (neighborhood-detail.tsx). Could start with template-based auto-generated FAQs using existing stats data, then add manual content later. Good SEO value with FAQ rich snippets.