2026-05-24

How FinSim Turns Country Rules Into Models

A concise note on how authored country notes stay connected to source tax rules.

FinSimLab keeps tax and investment behavior in source-controlled country rule files. Public country notes are authored separately so they can explain modelling choices, omissions, and confidence level in plain language.

The build does not generate the country-note text from the tax rules. It only renders authored Markdown to HTML and validates the generated links. The Demo Country model shows the free ruleset, while the Ireland model shows how a real-country note is presented.

The static pages are generated during the production build even when blog navigation is disabled in application configuration. That lets release tooling validate content and links without requiring the app UI to expose the section immediately.