Skip to content

Contributing to Awesome IIUM

Thank you for your interest in contributing to Awesome IIUM! We aim to build the most comprehensive and high-quality resource for the IIUM community.

To keep this list high-quality, please ensure your contribution:

  • Is relevant to IIUM: It should be useful for students, staff, or alumni.
  • Is active: The resource (link, app, group) should be currently active and maintained.
  • Adds value: Avoid generic resources unless they have a specific use case for IIUM (e.g., specific student discounts).
  • Alphabetical Order: Please keep the list sorted alphabetically within each category.
  • Format: [Name](Link) - Description.
    • Name: Capitalized correctly.
    • Link: Direct link to the resource.
    • Description: Short, clear, and ends with a period.
  • No Self-Promotion: If you are the author, please state it in the PR but keep the description objective.
  1. Fork the repository: Click the “Fork” button at the top right of this page.

  2. Clone your fork:

    Terminal window
    git clone https://github.com/YOUR-USERNAME/Awesome-IIUM.git
    cd Awesome-IIUM
  3. Create a branch:

    Terminal window
    git checkout -b add-my-awesome-resource
  4. Make your changes: Add your resource to the appropriate file in categories/.

  5. Commit your changes:

    Terminal window
    git commit -m "Add [Resource Name] to [Category]"
  6. Push to your fork:

    Terminal window
    git push origin add-my-awesome-resource
  7. Submit a Pull Request: Go to the original repository and click “Compare & pull request”.

If you find a broken link or outdated information, please open an issue describing the problem.

Thank you for helping us make IIUM awesome! 🚀