Skip to content

CONTRIBUTING.md

Latest commit

 

History

History
79 lines (58 loc) · 2.99 KB

CONTRIBUTING.md

File metadata and controls

79 lines (58 loc) · 2.99 KB

🏗️ 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:

  1. Fork the project repository.
  2. Create a new branch for your changes.
  3. Make your changes adhering to project guidelines.
  4. Commit: Your commit messages MUST follow these conventions:
  5. Open a Pull Request (PR) against the main branch.

🏛️ 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!