Getting Started

Before you start contributing, you'll need a few things set up:

  • GitHub Account: We use GitHub for all our code and issue tracking.
  • Git: Make sure you have git installed and configured.
  • Development Environment: Depending on what you work on, you might need Python, C compilers, or web tools.

Workflow

We follow a standard Fork-and-Pull workflow:

  1. Fork the repository you want to work on.
  2. Clone your fork locally.
  3. Create a Branch for your feature or fix (e.g., fix/login-bug).
  4. Commit your changes with clear messages.
  5. Push to your fork and submit a Pull Request (PR).

Coding Standards

To keep our codebase clean, please adhere to these rules:

  • Python: Follow PEP 8.
  • Bash: Use shellcheck to verify scripts.
  • Commits: Use imperative mood (e.g., "Fix login bug" not "Fixed login bug").

Documentation

Our Wiki is built with simple HTML/CSS. To contribute:

  • Edit the pages directly in the wiki/ directory.
  • Ensure all links are relative and working.
  • Use the existing CSS classes for consistency.

Translation

We use standard tools for localization:

  • Applications: We use .po files (Gettext).
  • Website: We are transitioning to a JSON-based system (currently disabled for stability).