Project

General

Profile

Proposition Scénario #14685

wiki/GitBonnesPratiques : rédiger de façon plus concise avec une langage plus neutre

Added by Klaas TJEBBES over 7 years ago. Updated over 7 years ago.

Status:
À formaliser
Priority:
Normal
Assigned To:
-
% Done:

0%

Spent time:

Description

Afin de faciliter la compréhension des contributeurs, je pense aux contributions sur wpkg-package, il faudrait revoir la page :
https://dev-eole.ac-dijon.fr/projects/eole/wiki/GitBonnesPratiques

Les informations qu'elle contient sont pertinentes mais trop "habillées/romantique".

Cette page devrait :
  • utiliser un ton plus neutre ("Trop de pull, c’est trop chaud !" ne convient pas pour une documentation technique)
  • être plus concis :
    Que se passe-t-il si un jour nous souhaitons apprendre les nouvelles
    histoires de par le monde ?
    
    Que ce passe-t-il si un jour nous souhaitons partager nos petites
    histoires avec le reste du monde ?
    
    La plupart du temps, la réponse donnée à ces questions commence par
    quelque chose comme « fais-toi donc un pull ».
    

    doit pouvoir se résumer en quelques mots.

Bref, faire une page qui soit lisible, technique et concise.

Dans l'état actuel, les utilisateurs (novices en "git") qui lisent cette page ont plutôt tendance à fuir qu'à essayer de comprendre, c'est dommage...

History

#1 Updated by Gérald Schwartzmann over 7 years ago

  • Tracker changed from Demande to Proposition Scénario
  • Category set to Version mineure

Cette page wiki était au départ à destination de l'équipe.

Selon la méthode décidé en équipe l'autre jour, les demandes internes ne se font plus dans le tracker demande :
https://dev-eole.ac-dijon.fr/projects/modules-eole/wiki/Gestion_des_demandes_entrantes

Je la déplace donc.

Une page wiki sur le projet wpkg-package pour les contributeurs à wpkg-package serait plus judicieux, à discuter.

#2 Updated by Gérald Schwartzmann over 7 years ago

  • Project changed from Distribution EOLE to wpkg-package
  • Category deleted (Version mineure)
  • Status changed from Nouveau to À formaliser

#3 Updated by Klaas TJEBBES over 7 years ago

Aujourd'hui les contributions se font essentiellement sur wpkg-package mais pas seulement.

Je pense également à "demain", à une page généraliste expliquant les manipulations de bases :
  • configuration git
  • git checkout/pull/commit/push
  • git branch
  • git merge
  • git log (git log --all --pretty=format:"%h %cd %s (%an)" --since='7 days ago')
  • git status
  • git add/rm/mv
  • git hist (git hist master --all)
  • git tag
  • git reset
  • git revert
  • autre ?

Also available in: Atom PDF