🚀 FOSS Glossary

A community-driven glossary of FOSS terms with humor, sarcasm, and honest truths

about open source culture.

---

🔗 Quick Links

• 📖 Landing Page — Browse the latest terms
• 📱 PWA — Full glossary with offline support & installable app
• 📋 Terms Data (JSON API) — Developer-friendly JSON endpoint (2 MB size limit)
• 🤖 AGENTS.md — Automation playbook (100% compliant)
• 📊 GitHub Actions — CI/CD status & workflows

---

🔄 CI/CD Pipeline

Our automated pipeline ensures quality and keeps the glossary up-to-date:

┌─────────────────────────────────────────────────────────────────┐
│                     CONTRIBUTOR WORKFLOW                         │
└─────────────────────────────────────────────────────────────────┘
                              │
                              ▼
                    ┌──────────────────┐
                    │  Create PR with  │
                    │  terms.yaml edit │
                    └────────┬─────────┘
                             │
                             ▼
         ┌───────────────────────────────────────┐
         │   pr-comment.yml (PR Validation)       │
         ├───────────────────────────────────────┤
         │  1. ✓ Schema validation               │
         │  2. ✓ TypeScript types check          │
         │  3. ✓ YAML sorting check              │
         │  4. ✓ Duplicate detection             │
         │  5. ✓ Exporter schema check           │
         │  6. ✓ Score new term (0-100)          │
         │  7. ✓ Post comment with results       │
         └───────────────┬───────────────────────┘
                         │
                    Pass │ Fail
                         │
           ┌─────────────┴─────────────┐
           │                           │
           ▼                           ▼
    ┌──────────┐              ┌──────────────┐
    │  Merge   │              │  Fix Issues  │
    │  to main │              │  & Re-run CI │
    └────┬─────┘              └──────────────┘
         │
         ▼
┌────────────────────────────────────────────────────────────┐
│        POST-MERGE: update-landing-page.yml                 │
├────────────────────────────────────────────────────────────┤
│  Trigger: push to main (terms.yaml changes)                │
│                                                             │
│  Jobs:                                                      │
│  1. Generate landing page (docs/index.html)                │
│     └─ npm run generate:landing                            │
│  2. Validate landing page sync                             │
│     └─ npm run validate:landing                            │
│  3. Export terms bundle (if new slugs)                     │
│     └─ npm run export:new → docs/terms.json                │
│        • Metadata: version (SHA), timestamp, count         │
│        • Size limit: 2 MB                                  │
│  4. Deploy to GitHub Pages                                 │
│     └─ Uploads docs/ artifact                              │
│     └─ Deploys to luminlynx.github.io/FOSS-Glossary       │
└────────────────────────────────────────────────────────────┘
         │
         ▼
┌─────────────────────────────────────────────────────────────┐
│                    DEPLOYMENT COMPLETE                       │
├─────────────────────────────────────────────────────────────┤
│  ✓ Landing Page: https://luminlynx.github.io/FOSS-Glossary │
│  ✓ Terms API: .../terms.json (cache: 1yr, immutable)       │
│  ✓ PWA: .../pwa/ (offline support)                         │
└─────────────────────────────────────────────────────────────┘

Other Automated Workflows

• readme-stats.yml - Updates README statistics (terms count, contributors)
• issue-task-pr.yml - Automates issue → task branch → PR creation
• pr-comment.yml - Validates PRs and provides scoring for all contributors
• pr-welcome.yml - Welcomes new contributors

📚 Detailed Pipeline Documentation | 🔧 Operations Runbook

---

📊 Glossary Stats

Total Terms: 28 | Contributors: 5 | Terms with Humor: 28 (100%)

🏆 Current Champion: License Proliferation with ~98/100 points!

Recent additions: Zombie Dependencies, YOLO Deploy, Yak Shaving

🎮 Top Contributors

🥇 copilot-swe-agent[bot] | 🥈 John Portley | 🥉 Joao Portela | 🌟 Aditya Kumar Singh | 🌟 Joe Port

🎮 How to Contribute

1. Fork this repo
2. Add your term to terms.yaml
3. Submit a PR
4. Get your quality score (try to beat 80/100!)
5. Earn achievements! 🏆

📊 Scoring System

Every term is scored out of 100 points:

• Base Definition: 20 points
• Humor: Up to 30 points (be funny!)
• Explanation: 20 points
• Cross-references: Up to 20 points
• Tags: 10 points

🏆 Achievements

• 😂 Comedy Gold - Write humor over 100 characters
• 💯 Perfectionist - Score 90+ points
• 🔥 Flame Warrior - Document controversial topics
• 📜 Historian - Add historical context

Example Term

- slug: git
  term: 'Git'
  definition: "A distributed version control system that lets teams branch, merge, and rewind project history so collaboration happens without overwriting each other's work."
  explanation: 'Git snapshots every commit locally, syncs through remotes, and helps keep parallel experiments manageable when they eventually converge.'
  humor: 'Like a time machine for code that mostly works—until you run `git push --force` and become the office supervillain.'
  tags: ['vcs', 'tools', 'collaboration']
  see_also: ['GitHub', 'GitLab', 'Mercurial']
  aliases: ['git-scm', 'version-control']
  controversy_level: 'medium'

🌐 Visit our Documentation

Check out our beautiful docs site with scoring explanation and examples!