🏗️ CONTRIBUTING to LUGAN
LUGAN is built by its community. We don’t just use open source software; we build it, research it, and govern it together. Your input is vital.
🚦 Before You Start
Important: To ensure a welcoming and productive environment, please review our Code of Conduct.
🗺️ Quick Map: What do you want to do?
Find your path based on the type of contribution:
| If you want to… | Go to… | Action Required |
|---|---|---|
| Write Code / Docs | GitHub Repositories | Fork & Pull Request (PR) |
| Report Bugs / Request Features | GitHub Issues | Open an Issue |
| Change Group Rules | GitHub Issues | Open a Proposal Issue |
| Vote on Decisions | GitHub Discussions | Participate in Polls |
| Share Quick Ideas | Telegram / Discord | Chat |
| Debate in Person | UNIVPM | Meetings & Workshops |
💻 Path A: Technical Contributions (Code & Docs)
All development happens on our GitHub repositories.
1. Reporting Bugs or Requesting Features
Not ready to write code? No problem.
- Go to the relevant project repository.
- Open an Issue.
- Use a clear title and follow the provided template (if available).
2. Submitting Changes (Workflow)
If you are contributing code or fixing documentation:
- Fork the project repository.
- Create a new branch for your changes.
- Make your changes adhering to project guidelines.
- Commit: Your commit messages MUST follow these conventions:
- YASE - setup git repo
- Conventional Commits (e.g.,
feat: add new login page,fix: correct typo in readme).
- Open a Pull Request (PR) against the
mainbranch.
🏛️ Path B: Governance (Rules & Structure)
LUGAN’s structure is managed collaboratively via “Organization as Code.”
1. Proposing Changes to Guidelines
Do you want to modify the MANIFESTO, Code of Conduct, or internal rules?
- Treat these documents like code.
- Open an Issue in the main LUGAN repository.
- Explain the reasoning and the intended impact clearly.
2. Formal Voting
For key decisions (elections, budgets, new policies):
- Go to the GitHub Discussions tab.
- Look for Polls to cast your formal vote transparently.
🗣️ Path C: Community & Quick Sync
Not every contribution requires a formal procedure.
Chat & Immediate Feedback 🚀
For spontaneous ideas or quick affirmation (“Yes, let’s do it!”):
- Join our Telegram or Discord channels (see JOIN_US.md).
- Use the chat for quick polls and to gauge immediate community sentiment.
In-Person Discussion 🎙️
For deep debates and workshops:
- Join us at UNIVPM: this is the space to challenge ideas, propose research, and discuss opinions face-to-face.
Thank you for helping us build LUGAN!