🚀 Contribute Wing

A beginner-friendly open-source repository designed to master Git & GitHub workflows through hands-on practice (Fork, Clone, Branch, Commit, Push, and PRs).

A beginner-friendly sandbox where developers take their first real steps into open source — no complex codebase, no pressure, just the actual Git & GitHub workflow used everywhere in the real world.

Created by Muhammad Mustafa (@Syntrojex)

---

👤 About the Author

Hey, I'm Muhammad Mustafa — I go by Syntrojex online. I'm a Software Engineering student who built this repository so other developers could get comfortable with Git & GitHub before jumping into real open-source projects.

GitHub: @Syntrojex LinkedIn: Muhammad Mustafa

---

📌 What Is This Repository?

Contribute Wing isn't a "real" software project with a codebase to maintain — it's a training ground. A safe, structured space where developers add two small files: a profile .md inside Contributions/_Contributors Profiles/, and a code snippet inside the matching language subfolder (e.g. Contributions/Python/):

• 📝 A short profile introducing themselves
• 💻 A code snippet in any programming language they like — C++, Python, Dart, JavaScript, Java, whatever they know

That's genuinely it. Simple enough for a complete first-timer, yet it walks you through the exact same steps used in real open-source contributions: fork → clone → branch → commit → push → pull request.

No complicated setup. No fear of breaking something important. Just the real workflow, practiced safely.

---

🧭 How It Works

Fork  →  Clone  →  Branch  →  Add Your Files  →  Commit  →  Push  →  Pull Request  →  Merged 🎉

1. Fork this repository to your own GitHub account
2. Clone your fork to your machine
3. Create a branch named after yourself
4. Add your files — a profile .md inside Contributions/_Contributors Profiles/ and a code snippet inside the matching language folder (e.g. Contributions/Java/)
5. Update the Contributors table with your entry
6. Commit, push, and open a Pull Request
7. Get merged and see your name live in the repository 🎉
8. The goal is to help beginners become comfortable with the real contribution workflow before contributing to larger or more complex open-source projects.

🌱 Start small. Practice the workflow. Then contribute to bigger projects with confidence.

---

📂 Repository Structure

Contribute-Wing/
├── README.md
├── Contributors.md
├── LICENSE
├── .gitignore
└── Contributions/
    ├── C/                     → sample.c
    ├── C#/                    → sample.cs
    ├── C++/                   → sample.cpp
    ├── Dart/                  → sample.dart
    ├── Go/                    → sample.go
    ├── Java/                  → sample.java
    ├── JavaScript/            → sample.js
    ├── Kotlin/                → sample.kt
    ├── PHP/                   → sample.php
    ├── Python/                → sample.py
    ├── Ruby/                  → sample.rb
    ├── Rust/                  → sample.rs
    ├── Swift/                 → sample.swift
    ├── TypeScript/            → sample.ts
    ├── _Contributors Profiles/  → your-name.md
    └── About The Author.md

Each language folder holds a sample.ext file for reference. To contribute, either copy sample.ext and rename it to your-name.ext, or create a fresh file — just make sure it lands inside the matching language folder (e.g. your-name.py inside Python/).

---

🤝 How to Contribute

1. Fork the Repository

Click Fork at the top-right of this repository's GitHub page.

2. Clone Your Fork

git clone https://github.com/Syntrojex/Contribute-Wing.git
cd Contribute-Wing

3. Create a Branch

git checkout -b YOUR-NAME

4. Add Your Two Files

Inside Contributions/, create:

1. Profile file: Contributions/_Contributors Profiles/your-name.md
2. Code file: inside the matching language folder — Contributions/[Language]/your-name.ext (create the language folder if it doesn't exist yet)

.cpp → C++      .py → Python     .js → JavaScript   .ts → TypeScript
.java → Java    .cs → C#         .dart → Dart        .html → HTML
.go → Go        .rb → Ruby       .kt → Kotlin        .swift → Swift
.php → PHP      .rs → Rust       .c → C

Use lowercase + hyphens, for example: your-name.md, your-name.cpp

📄 Profile Template — copy into your-name.md:

# 👨‍💻 Contributor Profile

![Contributor](https://img.shields.io/badge/STATUS-ACTIVE-brightgreen?style=for-the-badge)

## 📌 Personal Details

| Attribute | Details |
| :--- | :--- |
| **Full Name** | [Your Name] |
| **University** | [Your University] |
| **Semester** | [e.g. 3rd] |
| **Degree** | [e.g. BS Computer Science] |
| **GitHub** | [@your-username](https://github.com/your-username) |

## 🎯 Why I'm Contributing

* Practicing Git & GitHub workflow
* Learning to submit real pull requests
* Becoming part of the open-source community

💻 Code File Example — copy into your-name.ext:

Just raw code — no Markdown wrapping needed. Pick your language below to see a sample:

C++ — your-name.cpp

#include <iostream>
using namespace std;

int main() {
    cout << "Hello, World! Thanks for checking out my first PR 🎉" << endl;
    return 0;
}

Python — your-name.py

def main():
    print("Hello, World! Thanks for checking out my first PR 🎉")

main()

JavaScript — your-name.js

function main() {
    console.log("Hello, World! Thanks for checking out my first PR 🎉");
}

main();

Java — your-name.java

public class Main {
    public static void main(String[] args) {
        System.out.println("Hello, World! Thanks for checking out my first PR 🎉");
    }
}

C# — your-name.cs

using System;

class Program {
    static void Main() {
        Console.WriteLine("Hello, World! Thanks for checking out my first PR 🎉");
    }
}

Dart — your-name.dart

void main() {
  print("Hello, World! Thanks for checking out my first PR 🎉");
}

Go — your-name.go

package main

import "fmt"

func main() {
    fmt.Println("Hello, World! Thanks for checking out my first PR 🎉")
}

TypeScript — your-name.ts

function main(): void {
    console.log("Hello, World! Thanks for checking out my first PR 🎉");
}

main();

Kotlin — your-name.kt

fun main() {
    println("Hello, World! Thanks for checking out my first PR 🎉")
}

Swift — your-name.swift

print("Hello, World! Thanks for checking out my first PR 🎉")

PHP — your-name.php

<?php
echo "Hello, World! Thanks for checking out my first PR 🎉";

Rust — your-name.rs

fn main() {
    println!("Hello, World! Thanks for checking out my first PR 🎉");
}

Ruby — your-name.rb

puts "Hello, World! Thanks for checking out my first PR 🎉"

C — your-name.c

#include <stdio.h>

int main() {
    printf("Hello, World! Thanks for checking out my first PR 🎉\n");
    return 0;
}

5. Commit & Push

git add "Contributions/_Contributors Profiles/your-name.md" Contributions/[Language]/your-name.ext
git commit -m "Add [Your Name] as a contributor"
git push origin YOUR-NAME

6. Open a Pull Request

Go to your fork → Compare & pull request → add a short description → submit.

Once merged, you're officially a contributor ✅ — the maintainer will add your name to Contributors.md for you.

---

🌟 Contributors

See everyone who's contributed in Contributors.md — once your PR is merged, the maintainer will add your name there. No need to edit that file yourself.

---

🙏 Special Thanks

Thanks to Ali Khalid for the guidance and support that helped shape this repository. 🙌

---

📜 License

Licensed under the MIT License — free to fork, star, and use as a template.

---

⭐ If this repository helped you, consider giving it a star! ⭐

Created by Muhammad Mustafa (Syntrojex)