chore: Update documentation and add configuration files

- Enhanced CHANGELOG with recent additions, including datamart enhancements and improved export functionality.
- Added .gitignore and trunk.yaml files to manage project configurations and ignore unnecessary files.
- Updated various documentation files for improved readability and consistency, including architecture diagrams and guides.
- Introduced new configuration files for shellcheck and yamllint to standardize code quality checks across the project.

Author: angoca

.trunk/.gitignore

@@ -0,0 +1,9 @@
+*out
+*logs
+*actions
+*notifications
+*tools
+plugins
+user_trunk.yaml
+user.yaml
+tmp

.trunk/configs/.shellcheckrc

@@ -0,0 +1,7 @@
+enable=all
+source-path=SCRIPTDIR
+disable=SC2154
+
+# If you're having issues with shellcheck following source, disable the errors via:
+# disable=SC1090
+# disable=SC1091

.trunk/configs/.yamllint.yaml

@@ -0,0 +1,7 @@
+rules:
+  quoted-strings:
+    required: only-when-needed
+    extra-allowed: ["{|}"]
+  key-duplicates: {}
+  octal-values:
+    forbid-implicit-octal: true

.trunk/trunk.yaml

@@ -0,0 +1,38 @@
+# This file controls the behavior of Trunk: https://docs.trunk.io/cli
+# To learn more about the format of this file, see https://docs.trunk.io/reference/trunk-yaml
+version: 0.1
+cli:
+  version: 1.25.0
+# Trunk provides extensibility via plugins. (https://docs.trunk.io/plugins)
+plugins:
+  sources:
+    - id: trunk
+      ref: v1.7.4
+      uri: https://github.com/trunk-io/plugins
+# Many linters and tools depend on runtimes - configure them here. (https://docs.trunk.io/runtimes)
+runtimes:
+  enabled:
+    - go@1.21.0
+    - node@22.16.0
+    - python@3.10.8
+# This is the section where you manage your linters. (https://docs.trunk.io/check/configuration)
+lint:
+  enabled:
+    - actionlint@1.7.10
+    - checkov@3.2.499
+    - git-diff-check
+    - markdownlint@0.47.0
+    - prettier@3.8.1
+    - shellcheck@0.11.0
+    - shfmt@3.6.0
+    - sqlfluff@4.0.0
+    - taplo@0.10.0
+    - trufflehog@3.92.5
+    - yamllint@1.38.0
+actions:
+  disabled:
+    - trunk-announce
+    - trunk-check-pre-push
+    - trunk-fmt-pre-commit
+  enabled:
+    - trunk-upgrade-available

CHANGELOG.md

@@ -116,13 +116,17 @@ All notable changes to this project will be documented in this file.
 ### Added
 
 - **CI/CD Testing Infrastructure**: Added local CI testing scripts and improved test workflows
-- **Datamart Enhancements**: Added new tracking columns and metrics to datamartUsers and datamartCountries
-- **Enhanced Export Functionality**: Improved CSV and JSON export processes with incremental updates and conflict resolution
+- **Datamart Enhancements**: Added new tracking columns and metrics to datamartUsers and
+  datamartCountries
+- **Enhanced Export Functionality**: Improved CSV and JSON export processes with incremental updates
+  and conflict resolution
 
 ### Changed
 
-- **Documentation**: Comprehensive documentation updates including standardized links, metadata sections, and Mermaid diagrams
-- **ETL Process**: Enhanced ETL execution with improved phase handling and closed dimension date updates
+- **Documentation**: Comprehensive documentation updates including standardized links, metadata
+  sections, and Mermaid diagrams
+- **ETL Process**: Enhanced ETL execution with improved phase handling and closed dimension date
+  updates
 - **Database**: Updated SQL scripts to use public schema and improved query optimization
 - **Performance**: Optimized SQL queries, export processes, and added locking mechanisms
 - **Code Quality**: Standardized code formatting, improved error handling, and enhanced logging

LICENSE

@@ -5,6 +5,33 @@
  Everyone is permitted to copy and distribute verbatim copies
  of this license document, but changing it is not allowed.
 
+-------------------------------------------------------------------------------
+
+Copyright (C) 2025 Andres Gomez Casanova (AngocA), miembros de OSM Notes Latam
+
+This program is free software: you can redistribute it and/or modify
+it under the terms of the GNU General Public License as published by
+the Free Software Foundation, either version 3 of the License, or
+(at your option) any later version.
+
+This program is distributed in the hope that it will be useful,
+but WITHOUT ANY WARRANTY; without even the implied warranty of
+MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
+GNU General Public License for more details.
+
+You should have received a copy of the GNU General Public License
+along with this program.  If not, see <https://www.gnu.org/licenses/>.
+
+-------------------------------------------------------------------------------
+
+Documentation License
+
+All documentation files (including but not limited to `.md` files in the
+`docs/` directory, README files, and other documentation) are licensed
+under the GNU General Public License v3, the same license as the code.
+
+-------------------------------------------------------------------------------
+
                             Preamble
 
   The GNU General Public License is a free, copyleft license for

README.md

@@ -114,7 +114,9 @@ For complete navigation by role, see
 
 ## Architecture Decision Records
 
-Architecture Decision Records (ADRs) document important architectural decisions made in this project:
+Architecture Decision Records (ADRs) document important architectural decisions made in this
+project:
+
 - [View all ADRs](docs/adr/)
 - [Central ADR Index](https://github.com/OSM-Notes/OSM-Notes-Common/blob/main/docs/adr/README.md)
 
@@ -145,7 +147,8 @@ Architecture Decision Records (ADRs) document important architectural decisions
 
 ## Requirements
 
-For complete installation instructions, see **[Installation and Dependencies Guide](docs/Installation_Dependencies.md)**.
+For complete installation instructions, see
+**[Installation and Dependencies Guide](docs/Installation_Dependencies.md)**.
 
 ### Application Requirements
 
@@ -1214,10 +1217,14 @@ For more information about OSM licensing, see:
 For shared documentation of the complete ecosystem, see:
 
 - **[OSM Notes Ecosystem](https://github.com/OSM-Notes/OSM-Notes)** - Ecosystem landing page
-- **[Global Glossary](https://github.com/OSM-Notes/OSM-Notes-Common/blob/main/docs/Glossary.md)** - Terms and definitions
-- **[Complete Installation Guide](https://github.com/OSM-Notes/OSM-Notes-Common/blob/main/docs/Installation.md)** - Step-by-step installation of all projects
-- **[End-to-End Data Flow](https://github.com/OSM-Notes/OSM-Notes-Common/blob/main/docs/Data_Flow.md)** - Complete data flow
-- **[Decision Guide](https://github.com/OSM-Notes/OSM-Notes-Common/blob/main/docs/Decision_Guide.md)** - Which project do I need?
+- **[Global Glossary](https://github.com/OSM-Notes/OSM-Notes-Common/blob/main/docs/Glossary.md)** -
+  Terms and definitions
+- **[Complete Installation Guide](https://github.com/OSM-Notes/OSM-Notes-Common/blob/main/docs/Installation.md)** -
+  Step-by-step installation of all projects
+- **[End-to-End Data Flow](https://github.com/OSM-Notes/OSM-Notes-Common/blob/main/docs/Data_Flow.md)** -
+  Complete data flow
+- **[Decision Guide](https://github.com/OSM-Notes/OSM-Notes-Common/blob/main/docs/Decision_Guide.md)** -
+  Which project do I need?
 
 ---
 
@@ -1241,7 +1248,8 @@ OSM-Notes/
 └── OSM-Notes-Data/          # JSON data files (GitHub Pages)
 ```
 
-**All 8 projects are independent repositories**, working together to provide a complete OSM Notes analysis solution.
+**All 8 projects are independent repositories**, working together to provide a complete OSM Notes
+analysis solution.
 
 ### How Projects Work Together
 
@@ -1250,27 +1258,27 @@ graph TB
     subgraph External["External Sources"]
         OSM[OSM Planet/API]
     end
-    
+
     subgraph Base["Base Project"]
         INGESTION[OSM-Notes-Ingestion<br/>Base project]
     end
-    
+
     subgraph Processing["Processing Layer"]
         ANALYTICS[OSM-Notes-Analytics<br/>ETL → Data Warehouse<br/>this repo]
         WMS[OSM-Notes-WMS<br/>WMS layers]
     end
-    
+
     subgraph Delivery["Delivery Layer"]
         DATA[OSM-Notes-Data<br/>JSON files<br/>GitHub Pages]
         API[OSM-Notes-API<br/>REST API<br/>reads from Analytics DWH]
         VIEWER[OSM-Notes-Viewer<br/>Consumes JSON from Data]
     end
-    
+
     subgraph Support["Support Layer"]
         MONITORING[OSM-Notes-Monitoring<br/>Monitors all projects]
         COMMON[OSM-Notes-Common<br/>Shared libraries<br/>submodule]
     end
-    
+
     OSM -->|Downloads| INGESTION
     INGESTION -->|Base Tables| ANALYTICS
     INGESTION -->|Same Database| WMS
@@ -1284,7 +1292,7 @@ graph TB
     COMMON -.->|Used by| ANALYTICS
     COMMON -.->|Used by| WMS
     COMMON -.->|Used by| MONITORING
-    
+
     style OSM fill:#ADD8E6
     style INGESTION fill:#90EE90
     style ANALYTICS fill:#FFFFE0
@@ -1355,7 +1363,8 @@ When setting up the complete ecosystem, install projects in this order:
 8. **[OSM-Notes-Data](https://github.com/OSM-Notes/OSM-Notes-Data)**
    - JSON data files exported from Analytics
    - Served via GitHub Pages
-   - **Requires**: OSM-Notes-Analytics (generates and publishes the data via `exportAndPushJSONToGitHub.sh`)
+   - **Requires**: OSM-Notes-Analytics (generates and publishes the data via
+     `exportAndPushJSONToGitHub.sh`)
    - **Consumed by**: Viewer (primary consumer), API (optional)
 
 ### External Resources

docs/Architecture_Diagram.md

@@ -12,7 +12,6 @@ project: "OSM-Notes-Analytics"
 status: "active"
 ---
 
-
 # Architecture Diagram
 
 This document provides architecture diagrams for the OSM-Notes-Analytics system, following the C4
@@ -94,7 +93,8 @@ graph TB
 - **OSM-Notes-Viewer**: Downstream system consuming JSON exports from Data
 - **OSM-Notes-WMS**: Uses same database as Ingestion (geographic visualization)
 - **OSM-Notes-Monitoring**: Monitors all ecosystem components
-- **OSM-Notes-Common**: Shared library used by multiple systems (Ingestion, Analytics, WMS, Monitoring)
+- **OSM-Notes-Common**: Shared library used by multiple systems (Ingestion, Analytics, WMS,
+  Monitoring)
 
 **User Types:**
 
@@ -406,23 +406,23 @@ sequenceDiagram
 ```mermaid
 graph TD
     DB[PostgreSQL Database: osm_notes]
-    
+
     subgraph Public["Schema: public<br/>managed by OSM-Notes-Ingestion"]
         NOTES[notes]
         COMMENTS[note_comments]
         COMMENTS_TEXT[note_comments_text]
         USERS[users]
         COUNTRIES[countries]
     end
-    
+
     subgraph DWH["Schema: dwh<br/>managed by OSM-Notes-Analytics"]
         subgraph Facts["facts partitioned by year"]
             F2013[facts_2013]
             F2014[facts_2014]
             FDOTS[...]
             F2025[facts_2025]
         end
-        
+
         DIM_USERS[dimension_users]
         DIM_COUNTRIES[dimension_countries]
         DIM_DAYS[dimension_days]
@@ -434,34 +434,34 @@ graph TD
         DIM_SEASONS[dimension_seasons]
         DIM_AUTO[dimension_automation_level]
         DIM_EXP[dimension_experience_levels]
-        
+
         DM_USERS[datamartusers]
         DM_COUNTRIES[datamartcountries]
         DM_GLOBAL[datamartglobal]
     end
-    
+
     subgraph Staging["Schema: staging<br/>temporary, managed by ETL"]
         STAGE_2013[facts_2013 per-year staging]
         STAGE_2014[facts_2014 per-year staging]
         STAGE_DOTS[...]
     end
-    
+
     DB --> Public
     DB --> DWH
     DB --> Staging
-    
+
     Public --> NOTES
     Public --> COMMENTS
     Public --> COMMENTS_TEXT
     Public --> USERS
     Public --> COUNTRIES
-    
+
     DWH --> Facts
     Facts --> F2013
     Facts --> F2014
     Facts --> FDOTS
     Facts --> F2025
-    
+
     DWH --> DIM_USERS
     DWH --> DIM_COUNTRIES
     DWH --> DIM_DAYS
@@ -476,11 +476,11 @@ graph TD
     DWH --> DM_USERS
     DWH --> DM_COUNTRIES
     DWH --> DM_GLOBAL
-    
+
     Staging --> STAGE_2013
     Staging --> STAGE_2014
     Staging --> STAGE_DOTS
-    
+
     style DB fill:#90EE90
     style Public fill:#E0F6FF
     style DWH fill:#FFFFE0

docs/Atomic_Validation_Export.md

@@ -1,6 +1,8 @@
 ---
 title: "Atomic Validation Strategy for JSON Export"
-description: "Implementation guide for atomic validation in the JSON export process, ensuring data integrity during file generation"
+description:
+  "Implementation guide for atomic validation in the JSON export process, ensuring data integrity
+  during file generation"
 version: "1.0.0"
 last_updated: "2026-01-25"
 author: "AngocA"
@@ -13,7 +15,6 @@ project: "OSM-Notes-Analytics"
 status: "active"
 ---
 
-
 # Atomic Validation Strategy for JSON Export
 
 ## Overview

docs/Business_Glossary.md

@@ -12,7 +12,6 @@ project: "OSM-Notes-Analytics"
 status: "active"
 ---
 
-
 # Business Glossary
 
 This document provides business definitions for terms, concepts, and metrics used in the