diff --git a/CHANGELOG.md b/CHANGELOG.md new file mode 100644 index 0000000..4dd421d --- /dev/null +++ b/CHANGELOG.md @@ -0,0 +1,59 @@ +# 📋 CHANGELOG + +All notable changes to **.terra-legal** are documented here. + +Format: [Keep a Changelog](https://keepachangelog.com/en/1.0.0/) +Versioning: [Semantic Versioning](https://semver.org/) + +--- + +## [Unreleased] + +### Planned +- Zenodo DOI registration for CITATION.cff +- Translations: Russian (RU), Uzbek (UZ), German (DE) +- GitHub Actions compliance check workflow +- Terra Registry integration + +--- + +## [1.0.0] - 2026-03-03 + +### Added +- `DOCUMENTATION-STANDARD.md` — writing and structure guidelines +- `LINKING-INSTRUCTIONS.md` — how to connect repos to terra-legal layer +- `CHANGELOG.md` — this file +- `GOVERNANCE.md` — decision-making and maintainer structure + +### Notes +- Initial complete release of .terra-legal framework +- All core governance documents now present + +--- + +## [0.9.0] - 2025-07-16 + +### Added +- `LICENSE.md` — Terra Public License v1.0 (TPL-1.0) +- `CODE_OF_CONDUCT.md` — Child Safety First community guidelines +- `CONTRIBUTING.md` — contribution workflow +- `SECURITY.md` — vulnerability reporting policy +- `CITATION.cff` — academic citation metadata +- `README.md` — repository overview + +### Notes +- Initial release of Terra Public License v1.0 +- Child Safety First principle established as core value +- International compliance: GDPR Art.8, COPPA, UNESCO AI Ethics + +--- + +## LINKS + +- [Terra Public License v1.0](./LICENSE.md) +- [FMP Ecosystem](https://github.com/Secret-Uzbek/FMP-CENTRAL-REPO) +- [ORCID 0009-0000-6394-4912](https://orcid.org/0009-0000-6394-4912) + +--- + +*© 2025-2026 Abdurashid Abdukarimov. Terra Ecosystem.* diff --git a/DOCUMENTATION-STANDARD.md b/DOCUMENTATION-STANDARD.md new file mode 100644 index 0000000..3188762 --- /dev/null +++ b/DOCUMENTATION-STANDARD.md @@ -0,0 +1,187 @@ +# 📝 DOCUMENTATION STANDARD + +**Terra Ecosystem Documentation Guidelines** + +--- + +## 🎯 PURPOSE + +This standard ensures all Terra Ecosystem documentation is: + +- **Consistent** — same structure across all repositories +- **Accessible** — understandable by developers, educators, and parents +- **Multilingual** — ready for translation into RU, UZ, DE and other languages +- **Child-Safe** — never contains content harmful to children + +--- + +## 📁 REQUIRED FILES PER REPOSITORY + +Every Terra Ecosystem repository **MUST** contain: + +| File | Description | Priority | +|------|-------------|----------| +| README.md | Project overview, quick start | 🔴 Required | +| LICENSE.md | Terra Public License v1.0 | 🔴 Required | +| CITATION.cff | Academic citation metadata | 🔴 Required | +| CODE_OF_CONDUCT.md | Community behavior rules | 🔴 Required | +| CONTRIBUTING.md | How to contribute | 🔴 Required | +| SECURITY.md | Vulnerability reporting | 🔴 Required | +| CHANGELOG.md | Version history | 🟠 Recommended | +| GOVERNANCE.md | Decision-making structure | 🟠 Recommended | + +--- + +## 📄 README.md STRUCTURE + +```markdown +# Project Name +> One-line description + +## 🎯 Overview +What this project does and why it exists. + +## 🚀 Quick Start +Minimal steps to get running. + +## 📚 Documentation +Links to full docs. + +## 🤝 Contributing +Link to CONTRIBUTING.md + +## 📜 License +License name + link to LICENSE.md + +## 🔗 Part of FMP Ecosystem +Link to FMP-CENTRAL-REPO +``` + +--- + +## ✍️ WRITING STYLE + +### Language + +- **Primary:** English +- **Secondary:** Russian, Uzbek, German +- Use **simple, clear sentences** — max 20 words per sentence +- Avoid jargon without explanation +- Spell out acronyms on first use: FMP (Fractal Metascience Paradigm) + +### Tone + +- Professional but approachable +- Inclusive — no gendered language +- Respectful of all cultures and religions +- Child-safe — always + +### Formatting + +``` +# H1 — Document title only (once per file) +## H2 — Major sections +### H3 — Subsections + +**Bold** — for key terms, warnings +*Italic* — for titles, foreign words +Code — for commands, filenames, variables +> Blockquote — for important notes +``` + +--- + +## 🔢 VERSIONING STANDARD + +All documents follow **Semantic Versioning** (MAJOR.MINOR.PATCH): + +- **PATCH** — Typo fixes, clarifications +- **MINOR** — New sections, additions +- **MAJOR** — Breaking changes, restructuring + +### Changelog Entry Format + +```markdown +## [1.2.0] - 2026-01-15 + +### Added +- New section on AI ethics + +### Changed +- Updated child safety requirements + +### Fixed +- Typo in Section 3.2 +``` + +--- + +## 🌍 MULTILINGUAL DOCUMENTATION + +### Translation Structure + +``` +docs/ +├── en/ # English (primary) +├── ru/ # Russian +├── uz/ # Uzbek +└── de/ # German +``` + +### Translation Rules + +1. Translate **meaning**, not word-for-word +2. Preserve technical terms in English + local language +3. Keep emoji — they are universal +4. Mark machine-translated files with [MT] prefix until reviewed + +--- + +## 🔗 LINKING STANDARD + +**Internal links:** +```markdown +[Contributing Guide](./CONTRIBUTING.md) +``` + +**Cross-repository:** +```markdown +[FMP Central](https://github.com/Secret-Uzbek/FMP-CENTRAL-REPO) +[Terra Legal](https://github.com/AIUZ-Terra-Codex-EcoSystem/.terra-legal) +``` + +--- + +## 📊 CITATION.cff TEMPLATE + +```yaml +cff-version: 1.2.0 +message: "If you use this software, please cite it as below." +type: software +title: "Repository Title" +authors: + - family-names: Abdukarimov + given-names: Abdurashid + orcid: "https://orcid.org/0009-0000-6394-4912" + affiliation: "Fractal Metascience Foundation, Tashkent" +repository-code: "https://github.com/Secret-Uzbek/REPO-NAME" +license: CC-BY-4.0 +date-released: "YYYY-MM-DD" +version: "1.0.0" +``` + +--- + +## ✅ DOCUMENTATION CHECKLIST + +- [ ] All required files present +- [ ] README follows standard structure +- [ ] No broken internal links +- [ ] CITATION.cff is valid YAML +- [ ] No child-unsafe content +- [ ] Translations marked [MT] if machine-generated + +--- + +*© 2025 Abdurashid Abdukarimov. Terra Ecosystem.* +*Version: 1.0.0 — March 2026* diff --git a/GOVERNANCE.md b/GOVERNANCE.md new file mode 100644 index 0000000..1e93f46 --- /dev/null +++ b/GOVERNANCE.md @@ -0,0 +1,131 @@ +# 🏛️ GOVERNANCE + +**Terra Ecosystem Decision-Making Structure** + +--- + +## 🎯 OVERVIEW + +This document defines how decisions are made in the Terra Ecosystem, +who maintains the .terra-legal framework, and how the community +participates in governance. + +--- + +## 👤 MAINTAINERS + +### Founder & Lead Maintainer + +| Name | Role | Contact | +|------|------|---------| +| Abdurashid Abdukarimov | Founder, Lead Maintainer | a.abdukarimov@fractal-metascience.org | +| ORCID: 0009-0000-6394-4912 | Fractal Metascience Foundation | Tashkent, Uzbekistan | + +### Responsibilities + +- Final decisions on license changes +- Child safety policy enforcement +- Commercial license approvals +- Community moderation oversight +- Legal enforcement coordination + +--- + +## 🗳️ DECISION-MAKING PROCESS + +| Type | Process | Timeline | +|------|---------|----------| +| Minor (typos, clarifications) | Maintainer approval | 48 hours | +| Moderate (new sections) | Community review → Maintainer | 7 days | +| Major (breaking changes) | Public consultation → Vote → Maintainer | 90 days | +| Child Safety (emergency) | Immediate maintainer action | 24 hours | + +### Community Input + +Community members may: +1. **Open an Issue** — propose changes or report problems +2. **Submit a PR** — contribute improvements +3. **Comment on Proposals** — during public consultation periods +4. **Vote on Major Changes** — >66% qualified majority required + +--- + +## 🔄 LICENSE AMENDMENT PROCESS + +``` +Phase 1: PROPOSAL (30 days) + → GitHub Issue opened with full proposal + → Community feedback collected + → Legal review initiated + +Phase 2: REVIEW (60 days) + → Independent legal review + → Child safety expert assessment + → International compliance verification + → Community vote (>66% required) + +Phase 3: IMPLEMENTATION (90 days) + → Backward compatibility maintained (min 2 years) + → Migration support for existing licensees + → Documentation updates + → New version tagged and released +``` + +--- + +## 🛡️ CHILD SAFETY GOVERNANCE + +Child safety decisions follow an **accelerated process**: + +1. **Report received** → Lead Maintainer notified immediately +2. **Assessment** → Within 24 hours +3. **Action taken** → Within 48 hours +4. **Post-incident review** → Within 7 days +5. **Policy update if needed** → Within 30 days + +**Child safety violations always bypass standard review.** + +--- + +## 📋 ROLES + +| Role | Authority | Appointed By | +|------|-----------|-------------| +| Contributor | Submit PRs/issues | Self | +| Reviewer | Review PRs | Lead Maintainer | +| Maintainer | Merge PRs, enforce CoC | Lead Maintainer | +| Lead Maintainer | Final authority | Founder | + +--- + +## 🌍 INTERNATIONAL ADVISORY + +For jurisdiction-specific decisions, Lead Maintainer may consult: + +- **Europe** — GDPR / EU AI Act experts +- **Central Asia** — Local law and Islamic values advisors +- **International** — UNESCO AI Ethics framework advisors +- **Child Safety** — UNICEF / local child protection agencies + +--- + +## 📊 TRANSPARENCY + +Annual Transparency Report includes: +- Governance decisions made +- Community participation statistics +- Child safety incidents and resolutions +- License enforcement actions + +--- + +## 📞 GOVERNANCE CONTACT + +**Email:** a.abdukarimov@fractal-metascience.org +**Subject prefix:** [GOVERNANCE] +**Response time:** 7 business days + +--- + +*© 2025-2026 Abdurashid Abdukarimov. Terra Ecosystem.* +*Version: 1.0.0 — March 2026* diff --git a/LINKING-INSTRUCTIONS.md b/LINKING-INSTRUCTIONS.md new file mode 100644 index 0000000..855fad9 --- /dev/null +++ b/LINKING-INSTRUCTIONS.md @@ -0,0 +1,122 @@ +# 🔗 LINKING INSTRUCTIONS + +**How to Connect Your Repository to Terra Legal Layer** + +--- + +## 🎯 OVERVIEW + +This guide explains how to link any repository in the Terra Ecosystem +to the .terra-legal governance framework. + +By linking, your repository: +- Inherits Terra Public License v1.0 +- Adopts Terra Code of Conduct +- Becomes part of the official Terra Ecosystem +- Gets listed in the Terra Registry + +--- + +## 🚀 QUICK LINK (3 steps) + +### Step 1 — Add .terra-legal reference to README + +```markdown +[![Terra Legal](https://img.shields.io/badge/license-TPL--1.0-7c6aff)](https://github.com/AIUZ-Terra-Codex-EcoSystem/.terra-legal) +[![Child Safety First](https://img.shields.io/badge/child_safety-first-00d4aa)](https://github.com/AIUZ-Terra-Codex-EcoSystem/.terra-legal/blob/main/CODE_OF_CONDUCT.md) + +## 📜 Legal & Governance + +This project is governed by the [Terra Legal Framework](https://github.com/AIUZ-Terra-Codex-EcoSystem/.terra-legal): + +- **License:** [Terra Public License v1.0](https://github.com/AIUZ-Terra-Codex-EcoSystem/.terra-legal/blob/main/LICENSE.md) +- **Code of Conduct:** [Terra Code of Conduct](https://github.com/AIUZ-Terra-Codex-EcoSystem/.terra-legal/blob/main/CODE_OF_CONDUCT.md) +- **Security:** [Security Policy](https://github.com/AIUZ-Terra-Codex-EcoSystem/.terra-legal/blob/main/SECURITY.md) +- **Contributing:** [Contribution Guide](https://github.com/AIUZ-Terra-Codex-EcoSystem/.terra-legal/blob/main/CONTRIBUTING.md) +``` + +### Step 2 — Create minimal LICENSE file + +``` +Terra Public License v1.0 + +Copyright (c) 2025-2026 Abdurashid Abdukarimov +ORCID: 0009-0000-6394-4912 +Fractal Metascience Foundation, Tashkent, Uzbekistan + +Full license: https://github.com/AIUZ-Terra-Codex-EcoSystem/.terra-legal/blob/main/LICENSE.md + +Child Safety First. Educational Freedom. Ethical Technology. +``` + +### Step 3 — Add CITATION.cff + +Use the template from DOCUMENTATION-STANDARD.md. + +--- + +## 📋 FULL INTEGRATION (recommended) + +For complete integration, copy these files to your repository: + +| Source | Destination | Action | +|--------|-------------|--------| +| .terra-legal/CODE_OF_CONDUCT.md | your-repo/CODE_OF_CONDUCT.md | Copy | +| .terra-legal/CONTRIBUTING.md | your-repo/CONTRIBUTING.md | Copy + customize | +| .terra-legal/SECURITY.md | your-repo/SECURITY.md | Copy | + +Or use git submodule: + +```bash +git submodule add https://github.com/AIUZ-Terra-Codex-EcoSystem/.terra-legal .terra-legal +ln -s .terra-legal/CODE_OF_CONDUCT.md CODE_OF_CONDUCT.md +ln -s .terra-legal/SECURITY.md SECURITY.md +``` + +--- + +## 🏗️ TERRA ECOSYSTEM STRUCTURE + +``` +Terra Ecosystem +│ +├── .terra-legal/ ← This repository (legal layer) +│ ├── LICENSE.md (TPL-1.0) +│ ├── CODE_OF_CONDUCT.md +│ ├── CONTRIBUTING.md +│ ├── SECURITY.md +│ ├── DOCUMENTATION-STANDARD.md +│ ├── LINKING-INSTRUCTIONS.md +│ ├── CHANGELOG.md +│ └── GOVERNANCE.md +│ +├── AIUZ-Terra-codex/ ← Educational platform +├── FMP-monograph/ ← Academic monograph +└── [your-repo]/ ← Links to .terra-legal +``` + +--- + +## ✅ VERIFICATION CHECKLIST + +After linking, verify: + +- [ ] LICENSE or LICENSE.md present with TPL-1.0 reference +- [ ] README.md contains Terra Legal section with badges +- [ ] CODE_OF_CONDUCT.md present +- [ ] SECURITY.md present +- [ ] CITATION.cff present with correct ORCID +- [ ] Repository topics include fractal-metascience and fmp + +--- + +## 📞 REGISTER YOUR REPOSITORY + +**Email:** a.abdukarimov@fractal-metascience.org +**Subject:** [TERRA REGISTRY] your-repo-name +**Include:** Repository URL, project description, primary language + +--- + +*© 2025 Abdurashid Abdukarimov. Terra Ecosystem.* +*Version: 1.0.0 — March 2026* diff --git a/README.md b/README.md index 57322d4..c75c29f 100644 --- a/README.md +++ b/README.md @@ -1,3 +1,6 @@ +[![Terra Legal](https://img.shields.io/badge/license-TPL--1.0-7c6aff)](https://github.com/AIUZ-Terra-Codex-EcoSystem/terra-legal) +[![Child Safety First](https://img.shields.io/badge/child_safety-first-00d4aa)](https://github.com/AIUZ-Terra-Codex-EcoSystem/terra-legal/blob/main/CODE_OF_CONDUCT.md) + # 🌐 UST MVP [![DOI](https://zenodo.org/badge/DOI/10.5281/zenodo.TODO.svg)](https://doi.org/10.5281/zenodo.TODO)