diff --git a/README.md b/README.md index 182d36a8d905..d5bcfdef32ce 100644 --- a/README.md +++ b/README.md @@ -1,52 +1,125 @@
- - - - -

The Algorithms - Python

- - + + + The Algorithms Logo + + +

🧩 The Algorithms β€” Python

+ +

+ A global open-source project where developers of all skill levels learn, code, and grow together β€” one algorithm at a time. +

+ + +

- Gitpod Ready-to-Code + Gitpod Ready - Contributions Welcome + Contributions Welcome - + Repo size - Discord chat + Discord Chat - Gitter chat + Gitter Community +

- -
+

- GitHub Workflow Status + GitHub CI - pre-commit + Pre-commit enabled - code style: black + Code style Ruff +

+ +

πŸ“š Learn. Contribute. Collaborate. Build your skills with real algorithms and open-source experience.

- -

All algorithms implemented in Python - for education πŸ“š

-Implementations are for learning purposes only. They may be less efficient than the implementations in the Python standard library. Use them at your discretion. +--- + +## 🧠 About the Project + +**The Algorithms – Python** is a learning-focused repository containing a variety of algorithms, data structures, and problem-solving approaches written in Python. +It’s a community effort to make algorithm learning more approachable and hands-on. + +πŸ’‘ Whether you’re a **beginner exploring your first pull request** or an **experienced developer refining your craft**, this project welcomes you! + +--- ## πŸš€ Getting Started -πŸ“‹ Read through our [Contribution Guidelines](CONTRIBUTING.md) before you contribute. +1. Read the [**Contribution Guidelines**](CONTRIBUTING.md) β€” they’ll help you set up your local environment and understand our workflow. +2. Pick an algorithm idea you’d like to implement or improve. +3. Submit your pull request β€” every contribution matters, no matter how small. + +> πŸ† **Tip:** Even fixing typos or improving documentation helps the project β€” and it counts toward open-source experience! + +--- + +## 🀝 How to Contribute + +We believe everyone can contribute β€” here’s how you can get involved: + +- 🧩 **Add a new algorithm or data structure** +- 🧠 **Optimize or refactor** an existing one +- 🧾 **Improve documentation** or code comments +- πŸ§ͺ **Add test cases** to increase reliability +- 🎨 **Enhance visuals or examples** for better understanding + +Check the [Issues tab](https://github.com/TheAlgorithms/Python/issues) β€” some are tagged with `good first issue` and are great starting points! + +--- + +## πŸŽ‰ Community Challenges -## 🌐 Community Channels +Want to go beyond code? Join our monthly **Algorithm Challenges** on Discord! +Each month we pick a topic (e.g., Sorting, Graphs, Dynamic Programming) and contributors compete in a friendly way to improve or implement related algorithms. -We are on [Discord](https://the-algorithms.com/discord) and [Gitter](https://gitter.im/TheAlgorithms/community)! Community channels are a great way for you to ask questions and get help. Please join us! +> 🧭 Participation badges and GitHub shoutouts are awarded to active contributors! -## πŸ“œ List of Algorithms +--- -See our [directory](DIRECTORY.md) for easier navigation and a better overview of the project. +## πŸ’¬ Join the Community + +Meet contributors, share knowledge, and learn collaboratively: + +- πŸ’» [Join our Discord](https://the-algorithms.com/discord) +- πŸ’‘ [Discuss on Gitter](https://gitter.im/TheAlgorithms/community) +- 🌎 [Follow The Algorithms](https://github.com/TheAlgorithms) + +We’re building not just a codebase β€” but a **learning community** that helps each other grow. + +--- + +## πŸ“‚ Explore Algorithms + +Browse through the [**Directory**](DIRECTORY.md) for all algorithm implementations, organized by topic and complexity level. +Each section includes beginner-friendly examples and explanations. + +--- + +## 🌟 Contributor Recognition + +Every contributor is a valuable part of this project. +We regularly feature top contributors and new members in our community newsletter. + +πŸ’¬ Join us β†’ contribute, learn, and get recognized! +You can also add yourself to the **Contributors Wall** once your PR is merged. + +--- + +
+ +🧑 Built with curiosity, collaboration, and community spirit by +The Algorithms Contributors + +