Contributing to Open Source

# Open Source Contribution Workflow:

workflow = [
    ("1. Find a project", [
        "Browse GitHub topics: python, beginner-friendly",
        "Look for 'good first issue' labels",
        "Stars: 100-10000 (active but not overwhelming)",
    ]),
    ("2. Fork & Clone", [
        "Fork the repo on GitHub",
        "git clone https://github.com/YOU/project.git",
        "git remote add upstream https://github.com/ORIGINAL/project.git",
    ]),
    ("3. Set up dev environment", [
        "python -m venv venv && source venv/bin/activate",
        "pip install -e '.[dev]'",
        "Run existing tests: pytest",
    ]),
    ("4. Create a branch", [
        "git checkout -b fix/issue-123-bug-description",
        "Make your changes",
        "Write/update tests",
    ]),
    ("5. Submit PR", [
        "Push: git push origin fix/issue-123",
        "Open Pull Request on GitHub",
        "Write clear description of changes",
        "Reference the issue: 'Fixes #123'",
    ]),
]

print("=== Open Source Contribution Guide ===\n")
for step, details in workflow:
    print(f"📌 {step}")
    for d in details:
        print(f"   • {d}")
    print()

# Good first projects for Python learners
print("=== Beginner-Friendly Projects ===")
projects = [
    ("python/cpython", "Python itself!"),
    ("psf/requests", "HTTP library"),
    ("pallets/flask", "Web framework"),
    ("pytest-dev/pytest", "Testing framework"),
    ("python-poetry/poetry", "Package manager"),
]
for name, desc in projects:
    print(f"  🔗 github.com/{name} — {desc}")