docs: improve overview section with better structure and metadata

- Add myst frontmatter with html_meta to all overview pages
- Rewrite introductions to be direct and useful
- Organize concepts by themes (architecture, data, security)
- Improve product configuration descriptions
- Follow contributor guidelines for sentence case and linking
- Remove corporate language in favor of clear explanations

Author: jeremi

docs/overview/concepts/index.md

@@ -3,29 +3,38 @@ review-status: reviewed
 review-date: 2025-09-01
 reviewer: Mark Penalosa
 migration-notes: "Added during 2025 documentation reorganization"
+myst:
+  html_meta:
+    "title": "OpenSPP Core Concepts"
+    "description": "Core concepts and theoretical foundations of OpenSPP social protection platform"
+    "keywords": "OpenSPP, concepts, digital public infrastructure, data protection, registry"
 ---
 
 # Concepts
 
-This section is dedicated to exploring the core concepts and theoretical foundations of OpenSPP platform. Unlike reference materials that focus on specific functionalities, this documentation provides a higher-level understanding of the principles and philosophies guiding OpenSPP's design and implementation.
+These concepts explain the theoretical foundations and design principles behind OpenSPP. Understanding them helps you make better decisions about implementation and customization.
 
-- {doc}`data_collection_validation`: This document outlines OpenSPP's approach to data, emphasizing data minimization, user consent, and versatile input methods. It also covers the platform's validation processes, including input validation, data integrity checks, and a mix of automated and manual validation.
+## Architecture and design
 
-- {doc}`data_protection`: This document details the principles of data protection within the context of Digital Public Infrastructure. It covers key concepts like lawfulness, data minimization, and accountability, and provides measures for implementing strong data protection.
+- **[Digital public infrastructure](digital_public_infrastructure.md)** - Essential components of DPI and how OpenSPP aligns with DPI principles through modular, interoperable architecture
 
-- {doc}`digital_public_infrastructure`: This document introduces the concept of Digital Public Infrastructure (DPI) and its essential components. It explains the role of DPI in social protection and how OpenSPP aligns with DPI principles through its modular and interoperable architecture.
+- **[Integrated beneficiary registry](integrated_beneficiary_registry.md)** - Key components of an IBR, its advantages, and its relationship with social registries
 
-- {doc}`extensibility`: This document explains how OpenSPP's foundation on the Odoo framework makes it a highly customizable, configurable, and extensible platform. It covers concepts like modular architecture, inheritance, and the use of a large ecosystem of pre-built modules.
+- **[Extensibility](extensibility.md)** - How OpenSPP's Odoo foundation enables customization through modular architecture and inheritance
 
-- {doc}`integrated_beneficiary_registry`: This document defines the Integrated Beneficiary Registry (IBR) and explains its role in social protection. It details the key components of an IBR, its advantages, and its relationship with a social registry.
+## Data management
 
-- {doc}`registrant_concepts`: This document introduces the key terminology related to registrants in OpenSPP. It defines what a registrant is and explains the core concepts of individuals, groups, group memberships, and their relationships within the system.
+- **[Registry key concepts](registry_key_concepts.md)** - Best practices for organizing data with a minimalistic approach and the four main registry structure components
 
-- {doc}`registry_key_concepts`: This document outlines the best practices for organizing data within the OpenSPP registry, emphasizing a minimalistic approach. It provides guidance on where to store different types of data and introduces the four main components of the registry's structure.
+- **[Registrant concepts](registrant_concepts.md)** - Core terminology for individuals, groups, group memberships, and their relationships
 
-- {doc}`user_management`: This document describes the user management framework in OpenSPP, which is designed to safeguard user data and control access to system features. It covers the two main approaches to user management and outlines best practices for ensuring security and efficiency.
+- **[Data collection and validation](data_collection_validation.md)** - Data minimization, user consent, versatile input methods, and validation processes
 
-By delving into these concepts, you will gain a deeper appreciation for how OpenSPP works, enabling you to make more informed decisions when configuring and utilizing the platform for your specific needs.
+## Security and governance
+
+- **[Data protection](data_protection.md)** - Principles of lawfulness, data minimization, and accountability within DPI context
+
+- **[User management](user_management.md)** - Framework for controlling system access and safeguarding user data with two management approaches
 
 ```{toctree}
 ---

docs/overview/features/index.md

@@ -3,11 +3,16 @@ review-status: needs-review
 review-date: 2025-06-04
 reviewer: migration-script
 migration-notes: "Added during 2025 documentation reorganization"
+myst:
+  html_meta:
+    "title": "OpenSPP Features"
+    "description": "Comprehensive features of OpenSPP social protection platform including registry, program management, and payment systems"
+    "keywords": "OpenSPP, features, social protection, registry, eligibility, payments, GIS"
 ---
 
 # Features
 
-OpenSPP delivers comprehensive social protection capabilities through modular, interoperable components that adapt to diverse program requirements and implementation contexts. Each feature area integrates seamlessly with others, creating a unified platform for managing complex social protection interventions.
+OpenSPP's features work together to deliver end-to-end social protection programs. Each component can be configured independently while maintaining seamless integration with others.
 
 ## Data Foundation
 

docs/overview/index.md

@@ -3,18 +3,88 @@ review-status: needs-review
 review-date: 2025-06-04
 reviewer: migration-script
 migration-notes: "Added during 2025 documentation reorganization"
+myst:
+  html_meta:
+    "title": "OpenSPP Overview"
+    "description": "High-level overview of OpenSPP social protection platform products, features, and concepts for decision makers"
+    "keywords": "OpenSPP, overview, social protection, SP-MIS, Social Registry, Farmer Registry"
 ---
 
 # Overview
 
-Welcome to the OpenSPP overview section. This section provides high-level information about OpenSPP's features, concepts, and product configurations for decision makers and new users.
+OpenSPP is a modular platform for delivering social protection programs. This section explains what it does, how it works, and whether it fits your needs.
 
-- {doc}`products/index`  
-- {doc}`features/index`  
-- {doc}`concepts/index`
-- {doc}`poc_and_pilot`
-<!-- - {doc}`case_studies/index` -->
+## Choose your product configuration
 
+OpenSPP offers three specialized configurations designed for different social protection scenarios:
+
+:::::{grid} 3
+:gutter: 2
+
+::::{grid-item-card} [SP-MIS](products/sp_mis.md)
+:link: products/sp_mis.md
+:link-type: doc
+
+Social Protection Management Information System for comprehensive program delivery including cash transfers, conditional assistance, and humanitarian interventions.
+::::
+
+::::{grid-item-card} [Social Registry](products/social_registry.md)  
+:link: products/social_registry.md
+:link-type: doc
+
+Centralized beneficiary database that serves as a single source of truth across multiple programs, reducing duplication and enabling better coordination.
+::::
+
+::::{grid-item-card} [Farmer Registry](products/farmer_registry.md)
+:link: products/farmer_registry.md
+:link-type: doc
+
+Agricultural-focused platform combining farm data, land management, and social protection for rural development and climate resilience programs.
+::::
+:::::
+
+[Explore all products →](products/index.md)
+
+## Understand core capabilities
+
+OpenSPP delivers comprehensive social protection through modular features that work together seamlessly:
+
+**Data Foundation**
+- [Unified registry](features/unified_registry.md) for consolidated beneficiary data
+- [GIS and land management](features/gis_land_management.md) for location-based targeting
+
+**Program Delivery**  
+- [Program management](features/program_management.md) across the complete lifecycle
+- [Eligibility and targeting](features/eligibility_targeting.md) with flexible rules
+- [Payment and disbursement](features/payment_disbursement.md) through multiple channels
+
+**System Infrastructure**
+- [Data integration and APIs](features/data_integration_apis.md) for interoperability
+- [Change management](features/change_management.md) with audit trails
+- [Grievance redress](features/grievance_redress.md) for accountability
+
+[View all features →](features/index.md)
+
+## Learn fundamental concepts
+
+Understanding OpenSPP's design principles and theoretical foundations:
+
+- [Digital public infrastructure](concepts/digital_public_infrastructure.md) - How OpenSPP aligns with DPI principles
+- [Integrated beneficiary registry](concepts/integrated_beneficiary_registry.md) - Registry architecture and design  
+- [Data protection](concepts/data_protection.md) - Privacy and security framework
+- [Extensibility](concepts/extensibility.md) - Platform customization capabilities
+
+[Explore all concepts →](concepts/index.md)
+
+## Plan your implementation
+
+Ready to explore OpenSPP for your organization? Our structured approach helps you validate fit and plan successful deployments:
+
+**[From proof of concept to pilot](poc_and_pilot.md)** - Comprehensive guide covering:
+- Proof of concept (4-8 weeks) for initial validation
+- Pilot implementation (3-6 months) for real-world testing  
+- Resource planning and success criteria
+- Prerequisites and decision frameworks
 
 ```{toctree}
 :maxdepth: 2

docs/overview/products/index.md

@@ -3,19 +3,27 @@ review-status: needs-review
 review-date: 2025-06-04
 reviewer: migration-script
 migration-notes: "Added during 2025 documentation reorganization"
+myst:
+  html_meta:
+    "title": "OpenSPP Product Configurations"
+    "description": "OpenSPP product configurations - SP-MIS, Social Registry, and Farmer Registry for social protection programs"
+    "keywords": "OpenSPP, SP-MIS, Social Registry, Farmer Registry, social protection"
 ---
 
 # Products
 
-This section provides a comprehensive overview of OpenSPP's core product configurations. It is designed to guide you through the setup and customization of the platform's key components, ensuring they are tailored to meet the specific needs of your social protection programs.
+OpenSPP offers three product configurations, each designed for specific social protection use cases. Choose the one that matches your program's needs.
 
-Within this section, you will find detailed information of the following products. 
+## Available configurations
 
-- {doc}`social_registry`: Manage a centralized database of individuals and households, which serves as the foundation for various social programs.
+### [SP-MIS](sp_mis.md)
+Social Protection Management Information System for running complete social programs. Manages the entire lifecycle from beneficiary enrollment through payment disbursement. Ideal for cash transfers, humanitarian aid, and social assistance programs.
 
-- {doc}`farmer_registry` Discover the tools and techniques for establishing a dedicated registry for farmers, enabling targeted agricultural interventions and support.
+### [Social Registry](social_registry.md)  
+Centralized database of individuals and households that serves multiple social programs. Provides a single source of truth across interventions, reducing duplication and improving coordination between programs.
 
-- {doc}`sp_mis` Manage the entire lifecycle of social protection programs, from beneficiary enrollment to payment disbursement.
+### [Farmer Registry](farmer_registry.md)
+Specialized registry for agricultural programs that bridges farming and social protection. Enables targeted agricultural interventions, input distribution, and climate-smart agriculture support for rural communities.
 
 
 ```{toctree}