Contents
Baratin
- shoutbox ou e-mail = bouton feu rouge pietons ?
Creer un compte sur le serveur trac
http://trac.sagemath.org/sage_trac/ (lien Register en haut à droite).
Remarque:
- l'username que vous voulez, habituellement, username = première lettre du prénom + nom (exemple nborie, slabbe, nthiery, vdelecroix, hivert, ncohen, tmonteil (cherchez l'erreur))
Reporter un bug
- Cliquer sur le lien "New ticket"
- Remplir les champs (voir plus bas)
- Sauvegarder
Remarques:
- Chacun-e est libre de fixer les bugs qu'il/elle veut, donc si vous voulez qu'une personne prenne en charge votre ticket, pensez à elle.
- Soyez précis et lisible.
- Essayez d’éviter les doublons.
- Un ticket ne doit pas représenter une tache insurmontable (ex: "Please could you implement species").
- Il n'y a pas d’éditeur pour attribuer les relectures, la relecture des patches est libre.
- Relisez les patchs des autres.
Exemple de workflow
http://trac.sagemath.org/sage_trac/ticket/10063
Exercice sans filet
Indication: pour pouvoir lire les liens suivants, **lancez votre notebook**
Voici une liste numérotée de bugs que vous allez devoir reporter. Notez que ce bug sera fixe par votre voisin-e dans l'expose suivant, donc essayez de lui faire comprendre le problème !
Aide: quels champs remplir pour ce type de bugs
- Type: defect
- Keywords: beginner, days28, ... (le mot clef beginner est la pour permettre aux nouveaux codeurs de s’entraîner, ces tickets sont listés séparément dans le "View tickets")
- Priority: minor
Summary: fix documentation in ... <- boulot
- Component: documentation
Description: ..... <- boulot
- cc: sage-combinat, tmonteil, toi-meme (et en general les personnes dont on espere qu'elles feront quelque chose (fix ou rewiew)).
Remarques:
- tous ces champs peuvent être modifiés a tout moment, et a chaque changement, les personnes mises en cc recevront un mail.
- les champs restants (author, reviewer,...) se rempliront au fil du temps.
Liste des bugs a reporter
un point dans le titre en trop en haut : http://localhost:8000/doc/live/reference/sage/calculus/calculus.html
un bloc d'exemple n'est pas interactif : http://localhost:8000/doc/live/reference/sage/combinat/cartesian_product.html
#10643: dans la méthode fatter, mettre les O(size(n)) en expression math : http://localhost:8000/doc/live/reference/sage/combinat/composition.html
dans la méthode keys(), l'exemple n'est pas compris comme tel : http://localhost:8000/doc/live/reference/sage/combinat/finite_class.html
dans la description de la classe sage.combinat.integer_vector.IntegerVectors_nnondescents les formules c[1]+...+c[k] ne sont pas en mode math: http://localhost:8000/doc/live/reference/sage/combinat/integer_vector.html
#10646: dans la classe sage.misc.abstract_method.AbstractMethod, ..topic: Discussion et ..topic: Implementation details (il faudra changer topic par rubric) : http://localhost:8000/doc/live/reference/sage/misc/abstract_method.html
dans Dynamic classes, ..topic: non-interprete : http://localhost:8000/doc/live/reference/sage/structure/dynamic_class.html
#10641: dans sage.misc.package.install_all_optional_packages, les arguments et True et False doivent etre mis en mode verbatim, et les examples doivent etre interpretes comme tels : http://localhost:8000/doc/live/reference/sage/misc/package.html
après "This behavior can induce major performance penalties when testing. Note that this issue does not impact the usual assert:", l'exemple n'est pas interprété (il manque probablement un :: ) : http://localhost:8000/doc/live/reference/sage/misc/lazy_format.html
après "Here are two corner cases:", l'exemple n'est pas interprété : http://localhost:8000/doc/live/reference/sage/misc/functional.html
dans sage.misc.preparser.reset_load_attach_path, un "SAGE_LOAD_ATTACH_PATH" is compris comme du latex : http://localhost:8000/doc/live/reference/sage/misc/preparser.html
cherchez l’énorme erreur ! : http://localhost:8000/doc/live/reference/sage/combinat/combinat.html
dans les méthodes FibonacciTree et HoffmanSingletonGraph, les exemples ne sont pas interprétés : http://localhost:8000/doc/live/reference/sage/graphs/graph_generators.html
il manque : après le mot EXAMPLE : http://localhost:8000/doc/live/reference/sage/combinat/kazhdan_lusztig.html
dans certaines méthodes (a lister), il manque : après le mot EXAMPLE et aussi certains exemples ne sont pas interprétés : http://localhost:8000/doc/live/reference/sage/algebras/iwahori_hecke_algebra.html
dans la méthode is_interval, les : après AUTHOR devraient être colles : http://localhost:8000/doc/live/reference/sage/graphs/generic_graph.html
pas de point dans le titre : http://localhost:8000/doc/live/reference/sage/plot/plot3d/base.html
exemple mal formaté : http://localhost:8000/doc/live/reference/sage/calculus/riemann.html
pas de point dans le titre : http://localhost:8000/doc/live/reference/sage/structure/category_object.html
pas de point dans le titre : http://localhost:8000/doc/live/reference/sage/calculus/functional.html
Du rab s'il vous reste du temps
Si ça ne vous suffit pas, faites-vous les dents sur days28-unreferenced_bugs et sur ce qui est inscrit au tableau. Vous pouvez aussi rajouter des demandes de nouvelles fonctionnalités, dans ce cas, remplacez "defect" par "enhancement".
Vous pouvez éditer la page d'accueil du trac et vous rajouter dans la liste des contributeurs.
Avant le café, gagnez du temps pour le prochain expose
# sage -clone brouillon