Participer à des projets open-sources avec Git et GitHub

a marqué ce sujet comme résolu.

Il y a des tonnes de façons différentes de participer à un projet Github, et la seule façon de ne pas faire n'importe quoi est de contacter les mainteneurs/lire les instructions de contribution/encore autre chose selon le projet.

Je devrais peut-être préciser ça au début du tutoriel, effectivement.

Or, j'ai l'impression que tu as rédigé ce tuto avec une seule vision en tête (qui doit être grosso-modo celle de ZdS) et que tu as écrit la liste des choses que tu as faites toi dans ton cas particulier pour participer.

Ouais, j'ai sûrement été pas mal influencé par le fonctionnement du projet ZdS. En fait, je me demande même si j'ai assez d'expérience dans les projets open-source pour écrire ce tutoriel.

Résultat des courses, on se retrouve juste avec une liste un peu décousue de boutons à cliquer et de commandes à taper sans avoir une vue d'ensemble, un recul général sur ce qui est en train de se passer. Tu mélanges des détails sans grande importance (enregistrer une clé SSH par exemple) avec des choses beaucoup plus capitales sans marquer de différence. Tout est un peu balancé en vrac sans trame de fond ni articulation, et de manière plutôt expéditive.

Ce n'est pas la première fois que j'entends ça donc je vais essayer d'améliorer ça et de rendre mon tutoriel plus vivant et plus instructif.

Du coup, j'aurais tendance à dire qu'il faut déjà que tu cernes bien toi-même le modèle participatif que tu souhaites présenter

Tu as raison.

et que tu évites de t'éparpiller dans tous les sens en ne gardant que ce qui est vraiment essentiel de comprendre.

J'ai quelques difficultés à organiser mes écrits mais je vais essayer de faire mieux !

+0 -0

Bonjour,

La bêta du contenu « Participer à des projets open-sources avec Git et GitHub » a été désactivée.

J'ai désactivé la béta le temps de rentrer dans le contenu et d'y appliquer quelques modifications substentielles. Ca reviendra rapidement, ne vous inquiétez pas.

+0 -0

Oyez oyez les agrumes !

Je vous annonce avec plaisir la ré-ouverture de la bêta du contenu « Participer à des projets open-sources avec Git et GitHub » ! Je vous souhaite une agréable lecture à l'adresse suivante :

Merci pour votre participation.

J'ai fait pas mal de modifs pour rendre le tutoriel moins orienté ligne de commandes et pour faire un peu mieux comprendre le principe de git.

Je vais bientôt le proposer à la validation, une fois que j'aurai glissé un mot sur les templates de PR/Issue.

+1 -0

Bonjour les agrumes !

La bêta a été mise à jour et décante sa pulpe à l'adresse suivante :

Merci d'avance pour vos commentaires.

Pas mal de modifs réalisées :

  • corrections diverses par situphen
  • ajout d'images pour montrer une vue plus graphique des actions à effectuer
  • reformulation de certaines phrase sur la manière de faire une pull/request ou d'y participer
  • ajout du cartouche zep-jesaisplusquoimaisdominusdevraitaimer

Le tuto a été envoyé en validation mais je pense que le staff est quelque peu overbooké en ce moment.

+0 -0

Salut,

C'est un peu dommage de l'envoyer en validation avant même d'attendre des retours sur la bêta…

Je viens de lire le tuto, et j'avoue que mon avis n'a pas changé depuis la dernière fois. Le tuto manque de relief dans les informations. Ça part dans tous les sens sans mettre de contraste d'importance entre ce qui tient du tuyau et ce qui est vraiment essentiel de comprendre. Si j'essaye de me mettre à la place du débutant, je ne pense pas que j'arriverai au bout du cours en ayant une idée précise de ce qui vient de se passer, et de comment différents concepts proches (comme commit, push, et pull request) s'articulent les uns avec les autres.

+0 -0

Du coup, il n'est peut être pas utile de le laisser en validation, ça évitera qu'un valido commence à travailler sur la version courante et que tu modifies des trucs entre temps.

+1 -0
Ce sujet est verrouillé.