Skip to content

Add dedicated Python docs flow#7

Draft
PavelMakarchuk wants to merge 3 commits intomainfrom
feature/python-interactive-guide
Draft

Add dedicated Python docs flow#7
PavelMakarchuk wants to merge 3 commits intomainfrom
feature/python-interactive-guide

Conversation

@PavelMakarchuk
Copy link
Copy Markdown
Contributor

Summary

  • split the country docs into route-based API and Python tracks with a country landing page
  • replace the mixed Python/API content on the API page with API-specific guidance and direct Python cross-links
  • add a dedicated Python docs page that pulls in the household simulation and microsimulation material from the educational notebooks, including sequential sidebar navigation and step-by-step progression
  • remove the broken relative Next asset prefix so nested routes load CSS and JS correctly in local development

Testing

  • npm run build

Notes

  • the microsimulation examples are currently concrete for the US track because the educational notebook material is US-specific
  • the header remains the primary API/Python switch; the duplicate in-page track switcher was removed

@vercel
Copy link
Copy Markdown

vercel bot commented Mar 31, 2026

The latest updates on your projects. Learn more about Vercel for GitHub.

Project Deployment Actions Updated (UTC)
household-api-docs Error Error Mar 31, 2026 11:41pm

Request Review

- Remove intermediate landing pages (/ and /[countryId]) — redirect to API docs
- Fix sidebar layout: use underscore syntax for Tailwind grid-cols, lower breakpoint to md
- Remove side info boxes, fold content into panel body text
- Add real computed outputs below code blocks in notebook style
- Add inline comments from educational notebooks to all code examples
- Replace summary cards with core concepts intro (entities, variables, parameters, periods)
- Remove redundant Situation shape block; add per-entity comments in quickstart code
- Auto-scroll to content top when switching topics
- Add d3-geo and topojson-client dependencies

Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
- Remove sidebar title and description — numbered steps are self-explanatory
- Remove "You reached the end of this sequence" message
- Remove "Before you start" heading from core concepts section
- Use exact DataFrame output with full precision

Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant