Site Content Documentation
Comprehensive overview of all pages, sections, pillars, and their organizational structure
Content Pillars
Eight main content areas organizing the site
Jobs
Job search and application guidance
Helps users find jobs, write CVs, prepare for interviews, and navigate job platforms
Work
Work culture and workplace norms
Explains Finnish work culture including communication, hierarchy, teamwork, and workplace etiquette
Legal
Legal requirements, permits, contracts
Covers work permits, taxation, social security, employee rights, healthcare, and unemployment benefits
Cities
City-specific information and guidance
Provides detailed information about major Finnish cities including housing, jobs, culture, and transport
Education
Educational resources and pathways
Information about universities, vocational training, degree recognition, and career switching
Finnish
Finnish language learning resources
Resources for learning Finnish including courses, online tools, practice groups, and language cafes
Life
Life outside work in Finland
Covers cost of living, housing, transport, healthcare, culture, childcare, leisure, and politics
Tools
Interactive tools and calculators
Practical tools including tax calculator, cost of living calculator, city comparison, CV builder, and contract checklist
Content Summary
Quick reference table of all content sections
| Section | URL Structure | Subpages | Description | Key Topics |
|---|---|---|---|---|
| Jobs | /[locale]/jobs | 6 | Job search and application guidance | Platforms, CV guide, interviews, remote jobs, English-speaking jobs |
| Work | /[locale]/work | 6 | Work culture and workplace norms | Communication, hierarchy, teamwork, feedback, breaks, etiquette |
| Legal | /[locale]/legal | 6 | Legal requirements, permits, contracts | Work permits, taxation, social security, employee rights, healthcare, unemployment |
| Cities | /[locale]/cities | 9 | City-specific information and guidance | Helsinki, Tampere, Turku, Oulu, Jyväskylä, Lahti, Vaasa, Espoo, Vantaa |
| Education | /[locale]/education | 9 | Educational resources and pathways | Universities, UAS, vocational training, degree recognition, career switching, online learning |
| Finnish | /[locale]/finnish | 4 | Finnish language learning resources | Courses, online tools, practice groups, language cafes, Swedish role |
| Life | /[locale]/life | 8 | Life outside work in Finland | Cost of living, housing, transport, healthcare, culture, childcare, leisure, politics |
| Tools | /[locale]/tools | 7 | Interactive tools and calculators | Tax calculator, cost of living calculator, city comparison, CV builder, contract checklist |
| Glossary | /[locale]/glossary | 29 | Terminology and definitions | Finnish terms, institutions, concepts (A-Kassa, ALV/VAT, DVV, HETU, Kela, Migri, etc.) |
Jobs Section
Job search and application guidance
Role
Helps users find jobs, write CVs, prepare for interviews, and navigate job platforms. Includes city-specific job listings and English-speaking job opportunities.
Work Section
Work culture and workplace norms
Role
Explains Finnish work culture including communication styles, flat hierarchies, teamwork approaches, feedback culture, break traditions, and workplace etiquette.
Legal Section
Legal requirements, permits, contracts
Role
Covers essential legal requirements including work permits, taxation, social security, employee rights, healthcare access, and unemployment benefits.
Cities Section
City-specific information and guidance
Role
Provides detailed information about major Finnish cities including housing options, job markets, culture, transport, and local amenities. Each city has dedicated pages for different aspects.
City Subpages
Each city can have subpages covering: culture, housing, jobs, and transport. Currently Helsinki has the most comprehensive coverage.
Education Section
Educational resources and pathways
Role
Information about universities, vocational training, degree recognition, career switching, online learning, integration courses, and Herizon educational programs.
Recognition of Foreign Degrees
Getting your degree recognized
Universities
Finnish universities
Universities of Applied Sciences
UAS programs
Open University
Open university studies
Vocational Training
Vocational education
Career Switching
Changing careers
Online Learning
Online education options
Integration Courses
Integration training
Herizon Programs
Herizon educational programs
Finnish Language Section
Finnish language learning resources
Role
Resources for learning Finnish including course options (free vs paid), online learning tools, practice groups, language cafes, and information about the role of Swedish in Finland.
Main Topics
- Importance of learning Finnish
- Free vs paid courses
- Online learning tools
- Language cafes and practice groups
Related Resources
Life Section
Life outside work in Finland
Role
Covers practical aspects of daily life including cost of living, housing search, public transport, healthcare access, Finnish culture, childcare options, leisure activities, and political system overview.
Tools Section
Interactive tools and calculators
Role
Practical interactive tools including tax calculator, cost of living calculator, city comparison tool, CV builder, contract checklist, downloadable resources, and employment rights guide.
Glossary
Terminology and definitions
Role
Alphabetically organized glossary of Finnish terms, concepts, and institutions relevant to work and life in Finland. Includes terms like A-Kassa, ALV/VAT, Business ID (Y-tunnus), DVV, HETU, Kela, Migri, and more.
Glossary Statistics
View Glossary →Content Organization
MDX content structure and translation system
MDX Content Structure
Content is organized in src/content/[locale]/ directories:
- •Each section has its own directory (jobs/, cities/, etc.)
- •Subpages can be nested directories or .mdx files
- •Frontmatter includes title, description, lastUpdated
- •Content is rendered server-side using MDX
Translation System
Multi-language support through:
- •3 languages: English (en), Spanish (es), Russian (ru)
- •Locale routing:
/[locale]/... - •Translation files: JSON files in
src/messages/ - •Fallback: Missing translations fall back to English
Navigation Structure
How users navigate the site
Search & Discovery
How users find content
Search Functionality
Site-wide search available in navigation header:
- •Keyboard shortcut: ⌘K (Mac) or Ctrl+K (Windows/Linux)
- •Searches across all pages and content
- •API endpoint:
/api/search
Content Discovery
Multiple ways users discover content:
- •Popular sections: Highlighted on homepage
- •City chips: Quick navigation to city-specific content
- •Related sections: Cross-linking between related topics
- •Overview boxes: Context on each main page
Internationalization
Multi-language support structure
Supported Languages
Implementation Details
- Routing: Next.js App Router with
[locale]dynamic segment - Library: next-intl for translations and routing
- Content: Separate MDX files per locale in
src/content/[locale]/ - Metadata: Locale-specific metadata and canonical URLs
Explore the Content
This documentation provides an overview of all content pillars, pages, and organizational structure. Use it as a reference for understanding the site architecture.