Bonjour à tous,
Alors voilà, j'ai une question aux personnes qui ont monté un projet de développement (peu importe le langage), un minimum long (s'étalant sur plus de 3 mois de travail) et qui ont travaillé avec d'autres personnes bénévoles sur ce projet.

Je travaille sur mon projet web tous les jours, et le code avance régulièrement bien. La codeuse qui travaille avec moi sur ce projet n'a le temps de s'investir qu'une fois par semaine, sur une durée de 4 heures. En ce moment (ça fait 2 mois qu'on a démarré), elle perd un peu la motivation car elle a l'impression de plus devoir comprendre le code que coder.

Cela ne m'étonne pas vraiment, je travaille au moins 4 fois par semaine (en dehors de notre plage commune) de nombreuses heures le code, qui se développe vite jusqu'à la séance commune de travail. J'indente et je commente le plus possible (bien que certaines petites parties de code ne soient pas commentées lorsqu'elles sont très récentes, mais il ne s'agit généralement de pas plus de 10 lignes).

Alors vous, en travaillant régulièrement, et une fois par semaine avec un bénévole, comment travailleriez-vous / avez-vous travaillé avec ? Est-ce que cela vous semble possible ? Personnellement les bouts de code qu'elle développent me permettent d'éviter de longues minutes de recherche, et me permettent d'apprendre pas mal de choses assez facilement (elle ne fait jamais les codes jusqu'au bout par manque du temps, du coup je pars toujours de ces débuts de code pour les terminer, et ça m'évite des prises de tête pour définir des fonctionnements en entier tout seul). Même si je comprends sa frustration puisque je l'ai moi-même ressenti en devant  chaque fois résumer tout ce qui a été fait durant la semaine.

D'autre part, pensez-vous que c'est constructif pour la personne ? Personnellement le temps que je prends à comprendre son code m'apprend beaucoup. J'imagine que lire le code d'un projet que l'on a pas entièrement codé seul est une histoire d'expérience aussi. Qu'en pensez-vous ?

Merci pour vous avis ! Il faut que je re-détermine notre manière de travailler

EDIT : Là la dernière chose à laquelle j'ai pensé c'est qu'elle développe ses codes totalement indépendamment du code global et que je l'intègre, mais j'ai peur que presque tout le code soit à refaire pour qu'il soit adapté de cette manière.

-
Edité par Céryste 13 février 2016 à 5:10:08

Est-ce que tu es sûr que l'architecture de ton projet est bonne ? Dans un projet avec un langage orienté objet tu devrais pouvoir lui confier facilement une tâche précise qu'elle serait à même de faire même sans connaitre le reste du projet.

Après, tu peux aussi commenter de façon exhaustive ton code, avec notamment l'équivalent des JavaDoc (le nom doit dépendre du langage, mais en gros ça te génère une doc automatiquement et ça permet de voir exactement ce que fais la classe / la fonction / etc...), et tu peux également faire un petit "rapport" journalier expliquant ce que tu as fais, de façon à ce qu'elle puisse lire ça rapidement pour se tenir à jour.

Bonjour Grand Smurf !
Le projet n'est pas en POO. Je n'ai jamais touché à la POO, et à vrai dire, je n'y connais rien. Mais c'est peut-être plus efficace pour travailler en groupe, je vais essayer.

Je vais regarder les JavaDoc.

Bonne idée les rapports aussi, merci

Et au niveau de la séparation des pages, est-ce que vous trouvez ça judicieux de découper les codes en 10 pages différentes intégrées à une même page plutôt que tous écrit dans la page ? Perso je trouve ça plus simple de naviguer au sein d'une page plutôt que dans 10 pages différentes.

-
Edité par Céryste 13 février 2016 à 19:28:30

Ah, bah dans ce cas tu devrais regarder l'architecture MVC pour pouvoir mieux organiser ton code, ça serait plus simple de travailler à plusieurs dessus.

Pour la question sur les différentes, regardes les différentes architectures qui existent. 

Parque qu'avoir un projet avec plein de petits fichiers semblent pas pratique au début. Mais plus le projet va grandir, plus tu vas te rendre compte que d'avoir des fichiers séparés (et du code découplé), c'est vachement pratique. 
Quand tu met tout sur la même page, toutes tes actions sont croisés, tu fais de la gestion de données (Modèle), de la vérification de paramètre pour appeler tes requêtes (Modèle et Contrôleur) et tu fais l'affichage sur la même page (Vue). Maintenant, si tu changes de la logique métire, tu va avoir plein de trucs à refaire sur ta "partie" contrôleur et ta "partie" vue parce que tout est lié. Si tu découples ton code (avec l'architecture MVC par exemple), un changement de logique dans le modèle ne va pas forcément  impacter le reste de ton code. 
Donc se mettre à une architecture, c'est gagner du temps sur l'évolutivité et la maintenabilité du code.