Défi Algorithmes Java : Implémentations et Tests avec Maven

À propos du Projet

Ce dépôt est le point central du Défi Algorithmes Java, un projet conçu pour renforcer votre maîtrise de la programmation Java, votre aisance avec Git et GitHub, et votre expérience avec Maven et JUnit. En vous engageant dans des défis algorithmiques et en contribuant des solutions, les participants seront bien préparés pour des projets plus complexes, notamment ceux impliquant Spring Boot.

Objectifs

• Utiliser Git et GitHub dans un contexte de projet réel.
• Améliorer les compétences en programmation Java en utilisant Java 17.
• Se familiariser avec la gestion de projet Maven.
• Écrire et exécuter des tests unitaires en utilisant le framework JUnit.

Comment Commencer

1. Forker le Projet : Commencez par forker le dépôt pour obtenir votre copie du projet.
2. Cloner le Dépôt : Clonez le dépôt forké sur votre machine locale pour commencer à y travailler.
3. Sélectionner une Issue : Choisissez une issue à laquelle vous souhaitez contribuer.
4. Créer une Nouvelle Branche : Pour chaque issue, créez une branche spécifique pour votre travail.

Contribution

Étapes pour Contribuer

1. Implémenter la Solution : Écrivez le code nécessaire pour résoudre l'issue choisie.
2. Écrire des Tests Unitaires : Assurez-vous d'inclure des tests unitaires pour votre code en suivant la méthodologie de développement dirigé par les tests (TDD).
3. Documenter Votre Code : Commentez votre code pour clarifier votre logique et les choix de conception.
4. Soumettre une Pull Request (PR) : Une fois votre solution prête et testée, créez une PR pour la fusionner dans le dépôt principal.

Directives de Soumission

• Nom de Branche : Utilisez le format feature/#NumeroIssue-description pour vos branches.
• Description de la PR : Fournissez une description claire et concise de vos changements lors de la soumission d'une PR.

Règles et Étiquette

• Chaque participant doit soumettre au moins un PR et effectuer au moins une revue d'un PR d'un autre contributeur.
• Favorisez un environnement d'apprentissage positif et respectueux. La critique constructive est encouragée, mais toujours avec bienveillance et respect.

Structure du Projet

Pour chaque issue résolue, il doit y avoir :

• Un seul fichier de test dans le package fr.afrogeek.algorithms dans le répertoire test.
• Un fichier d'implémentation dans le package fr.afrogeek.algorithms dans le répertoire main.

Cette structure maintient l'organisation du projet et assure que toutes les contributions suivent un format cohérent.

Technologies Utilisées

• Java 17
• Maven : Pour la gestion de projet et l'automatisation des builds.
• JUnit : Le framework utilisé pour les tests unitaires de nos solutions.

Ressources Utiles

• Documentation officielle de Java 17
• Guide de démarrage Maven
• Guide utilisateur de JUnit

Licence

Ce projet est sous licence MIT. Voir le fichier LICENSE pour plus de détails.