🔧 What We Fixed​

1. Homepage "Page Not Found" Error​

Problem:

• http://localhost:3000/ showed "page not found"
• Custom homepage at src/pages/index.tsx couldn't render
• CommunityOne logo missing
• Routing conflict with Docusaurus configuration

Solution:

• Changed routeBasePath from / to /docs/
• Docs now served at /docs/ path
• Custom homepage renders at root /
• Logo displays correctly

2. Updated All Navigation Links​

Fixed 7 files with 155 insertions:

Configuration Updates:

• docusaurus.config.ts - Navbar, footer, logo links
• src/pages/index.tsx - Homepage pathway cards, CTA buttons

Documentation Updates:

• intro.md - Updated all internal links to /docs/ prefix
• for-advocates.md - Fixed policy maker navigation
• for-developers.md - Corrected developer guide links
• dashboard.md - Updated dashboard references
• citations.md - Added Open Data Impact section

3. New URL Structure​

With routeBasePath: '/docs/':

✨ Homepage Features​

The new custom homepage includes:

Header:

• CommunityOne logo (SVG)
• "Open Navigator" branding
• Tagline: "Find opportunities in local meetings and budgets"

Audience Pathways: Two cards guiding users based on role:

• 📊 Policy Makers & Advocates → /docs/for-advocates
• 🛠️ Developers & Technical Users → /docs/for-developers

Feature Highlights:

• 📄 Meeting Minutes & Financial Documents (90,000+ jurisdictions)
• 🤖 Automated Analysis (AI-powered document processing)
• 💰 Words vs Money (Budget vs meeting minute correlation)
• 🔍 Free Public Data (Census, school district, nonprofit data)
• 🗺️ Visual Map (Geographic opportunity discovery)
• 📧 Draft Materials (Automated email and campaign content)

Call-to-Action:

• Launch main application (React app on port 5173)
• Access documentation sections
• Explore data sources

📊 Build Status​

Documentation now builds successfully:

• ✅ All routes working
• ✅ No TypeScript errors
• ✅ Logo displays correctly
• ✅ Navigation links functional
• ✅ Warnings for broken links identified (to be fixed next week)

🚀 What's Next​

Week of April 27:

• Add civic tech section to homepage
• Fix broken anchor links
• Update legacy markdown references
• Test deployment to HuggingFace Spaces

Week of May 4:

• Launch production deployment
• Set up custom domain (www.communityone.com)
• Configure OAuth providers
• Enable user authentication

Week of May 11:

• Start data extraction pipelines
• Ingest first batch of civic tech projects from GitHub
• Test hackathon event calendar
• Deploy brigade chapter directory

🎯 Roadmap: Weekly Blog Posts for 2026​

Here's what to expect in upcoming weekly updates:

May 2026: Production Deployment

• Week 1: HuggingFace Spaces deployment
• Week 2: Custom domain & SSL setup
• Week 3: OAuth integration (GitHub, Google)
• Week 4: First production users

June 2026: Data Extraction

• Week 1: GitHub API integration for civic tech projects
• Week 2: Hackathon event calendar (National Day of Civic Hacking)
• Week 3: Brigade chapter directory (Code for America)
• Week 4: First 1,000 civic tech projects indexed

July 2026: Analytics & Dashboards

• Week 1: Community solution templates
• Week 2: Metric views for common use cases
• Week 3: Budget-to-minutes correlation analysis
• Week 4: First real-world case study

August 2026: Community Engagement

• Week 1: Partner with first local brigade
• Week 2: Data Academy pilot program (Brookings model)
• Week 3: Hackathon participation (CodeAcross prep)
• Week 4: User feedback and iteration

September-December 2026: Scale & Impact

• Monthly: New jurisdiction data (target: 100K+ cities/counties)
• Monthly: Nonprofit data expansion (target: 5M+ organizations)
• Monthly: Meeting minute ingestion (target: 1M+ documents)
• Quarterly: Major feature releases

2027 Goals:

• Full coverage of U.S. jurisdictions
• International expansion (Canada, UK)
• Real-time meeting monitoring
• AI-powered policy impact predictions

📖 Try It Out​

Visit the new homepage at http://localhost:3000/ to see the redesigned landing page with pathway cards, feature highlights, and clear calls-to-action.

All documentation is now accessible with the /docs/ prefix - no more "page not found" errors!

Next Post: Production Deployment & HuggingFace Spaces Setup (Week of April 27)

✅ What We Accomplished​

1. Comprehensive Citations Page​

Migrated to Citations & Data Sources with:

• 46 data sources fully documented
• BibTeX citations for all academic research
• License information clearly stated
• Quick Navigation grid for easy browsing
• 1,837 lines of detailed attribution

2. Added Major Research Sources​

Open Data Impact (NYU GovLab):

• 19 global case studies analyzing what works in open data
• Economic impact: $3T/year (McKinsey estimate)
• Evidence-based validation of our platform approach
• Four impact dimensions: Government, Citizens, Opportunity, Problems

Community Solutions Research:

• Spectrum of Community Engagement to Ownership (Facilitating Power)
• Harvard Data-Smart City Solutions use case catalog
• Brookings Institution Data Academy model
• Real-world examples: Providence RI, Portland OR, Tempe AZ, Norfolk VA

3. Civic Tech & Open Source Section​

Created comprehensive civic tech citations:

• GitHub API - Repositories, hackathons, contributors (5,000 req/hour)
• Civic Tech Field Guide - 1,000+ projects catalogued
• Code for America - 80+ brigade chapters, hackathon events
• U.S. Digital Response - Emergency civic tech projects
• Digital Public Goods Alliance - 500+ DPG-certified projects

Hackathon Coverage:

• National Day of Civic Hacking (Annual, June)
• CodeAcross (Annual, February)
• Monthly Hack Nights

Notable Projects Cited:

• OpenBudget Oakland (Budget transparency)
• Food Oasis (Food access mapping, 300+ locations)
• Health Equity Tracker (CDC health disparities)
• BallotNav (Ballot drop-off locations)
• Documenters Network (Public meeting coverage)

4. Made Citations Prominent​

Added citations to:

• ✅ Navbar (top navigation)
• ✅ Footer (all pages)
• ✅ All sidebar navigations
• ✅ Homepage introduction
• ✅ For Advocates page
• ✅ For Developers page

📚 Citation Categories​

Our documentation now covers:

1. 🎓 Academic Research - MeetingBank, LocalView, Council Data Project, City Scrapers
2. 🏛️ Government Data - U.S. Census, NCES, IRS TEOS
3. 🌐 Civic Tech Standards - OCD-ID, Popolo, Schema.org, CEDS, OMOP CDM
4. 🗳️ Election & Advocacy - Ballotpedia, MIT Election Lab, OpenElections
5. 🏢 Nonprofit & Philanthropy - ProPublica, IRS, Every.org, Findhelp, 211, Microsoft CDM
6. 🌍 International Aid - IATI Standard v2.03
7. ✅ Fact-Checking - Google API, FactCheck.org, PolitiFact
8. 💼 Enterprise Tech - Microsoft, Google, AWS, Databricks, Snowflake, Oracle, Salesforce, Cisco, IBM, Meta
9. 💻 Civic Tech & Open Source - GitHub, Code for America, USDR, Civic Tech Field Guide, DPGA
10. 🌟 Community Solutions - Spectrum of Engagement, Harvard, Brookings, Open Data Impact

🔍 Why This Matters​

For Researchers:

• Cite our data sources in your publications
• Understand licensing and usage terms
• Find original dataset documentation

For Developers:

• Access API documentation and technical specs
• Understand data provenance
• Comply with attribution requirements

For Advocates:

• Know where the data comes from
• Trust the sources backing our analysis
• Reference credible research in your campaigns

🚀 What's Next​

Week of April 20:

• Fix homepage routing configuration
• Update internal documentation links
• Improve navigation structure
• Add civic tech projects to homepage

Week of April 27:

• Deploy updated documentation to production
• Test all citation links
• Verify BibTeX exports
• Add RSS feed for citation updates

📖 Try It​

Visit Citations & Data Sources to explore the complete attribution system. Every dataset, standard, and research source is properly cited with complete licensing information.

Next Post: Homepage Redesign and Navigation Improvements (Week of April 20)

🎯 What We Accomplished​

1. Added 8 New Civic Tech Entities​

We've integrated civic technology and open source projects as first-class data entities:

• CIVIC_TECH_PROJECT - GitHub repositories, civic tech projects
• PROJECT_CONTRIBUTOR - Maintainers and core contributors
• PROJECT_ISSUE - "Good first issue" labels for new contributors
• PROJECT_FUNDING - GitHub Sponsors, OpenCollective, grants
• HACKATHON - National Day of Civic Hacking, CodeAcross events
• HACKATHON_PROJECT - Projects built at civic hackathons
• HACKATHON_PARTICIPANT - Contributors and attendees
• BRIGADE_CHAPTER - Code for America brigade locations (80+ chapters)

2. Community Solutions Framework​

Added 3 entities to track real-world community engagement:

• COMMUNITY_SOLUTION - Implementation of engagement spectrum (Inform → Defer to)
• SOLUTION_STAKEHOLDER - CBOs, government, funders, facilitators
• SOLUTION_METRIC - Track KPIs, outputs, outcomes, and impact

This framework maps to research from:

• Spectrum of Community Engagement to Ownership (Facilitating Power)
• Harvard Data-Smart City Solutions (use case templates)
• Brookings Institution (Data Academy model)

3. Church & Congregation Data​

Integrated faith-based organizations into our nonprofit tracking:

• CONGREGATION entity with 20 fields
• Data sources: ARDA, HIFLD, National Congregations Study
• Coverage: Churches, mosques, synagogues, temples

📊 By the Numbers​

• 40+ entities in our comprehensive ERD
• 2,827 lines of data model documentation
• 90K+ jurisdictions tracked
• 3M+ nonprofits monitored
• 500K+ meeting pages indexed

🔮 What's Next​

Week of April 13:

• Migrate all citations to Docusaurus documentation
• Add comprehensive BibTeX references
• Expand enterprise tech partnerships section

Week of April 20:

• Fix homepage routing issues
• Update navigation structure
• Deploy civic tech section to documentation

Looking Ahead:

• Extract GitHub data for civic tech projects
• Build hackathon event calendar
• Create community solution templates

🚀 Try It Out​

Our data model is fully documented in the Data Model ERD with interactive Mermaid diagrams showing all entity relationships.

Want to contribute? Check out our GitHub repository or join a local Code for America brigade to see the data model in action!

Next Post: Citations Migration and Documentation Improvements (Week of April 13)