Differences between revisions 1 and 16 (spanning 15 versions)
Revision 1 as of 2011-01-17 22:55:26
Size: 985
Comment:
Revision 16 as of 2011-01-18 04:01:28
Size: 5296
Comment:
Deletions are marked like this. Additions are marked like this.
Line 1: Line 1:
Creez un compte sur [[http://trac.sagemath.org/sage_trac/]] (Register en haut a droite). <<TableOfContents()>>
Line 3: Line 3:
Quoi remplir?
  * Type: defect
  * Keywords: beginner, days28
  * Priority: minor
  * Summary: fix documentation in ...
  * Component: documentation
shoutbox = bouton feu rouge pieton ?

== Creer un compte sur le serveur trac ==
[[http://trac.sagemath.org/sage_trac/]] (lien Register en haut a droite).

habituellement, login = premiere lettre du prenom + nom (exemple slabbe, nthiery, vdelecroix, hivert, ncohen, tmonteil (cherchez l'erreur))
Line 11: Line 11:
Voici une liste numerotee de bugs que vous allez devoir reporter (puis eventuellement fixer). == Reporter un bug ==
  * Cliquer sur le lien "New ticket"
  * Remplir les champs (voir plus bas)
  * Sauvegarder
Line 13: Line 16:
Remarque: un ticket ne doit pas representer une tache insurmontable (ex: "Please could you implement species")


== 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 numerotee 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 probleme !

=== 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 se faire les dents, ces tickets sont listes separement dans le "View tickets")
  * Priority: minor
  * Summary: fix documentation in ... <- boulot
  * Component: documentation
  * Description: ..... <- boulot
  * cc: sage-combinat, tmonteil, moi-meme (et en general les personnes dont on espere qu'elles feront quelque chose (fix ou rewiew)).

Remarque: tous ces champs peuvent etre modifies a tout moment, et a chaque changement, les personnes mises en cc recevront un mail.

Remarque: les champs restants (author, reviewer,...) se rempliront au fil du temps.


=== Liste des bugs a reporter ===
Line 16: Line 46:
  1. : [[]]
  1. : [[]]
  1. : [[]]
  1. : [[]]
  1. : [[]]
  1. : [[]]
  1. : [[]]
  1. : [[]]
  1. : [[]]
  1. : [[]]
  1. : [[]]
  1. : [[]]
  1. : [[]]
  1. : [[]]
  1. : [[]]
  1. : [[]]
  1. : [[]]
  1. dans la methode keys(), l'exemple n'est pas compris comme tel : [[http://localhost:8000/doc/live/reference/sage/combinat/finite_class.html]]
  1. 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]]
  1. 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]]
  1. dans Dynamic classes, ..topic: non-interprete : [[http://localhost:8000/doc/live/reference/sage/structure/dynamic_class.html]]
  1. 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]]
  1. apres "This behavior can induce major performance penalties when testing. Note that this issue does not impact the usual assert:", l'exemple n'est pas interprete (il manque probablement un :: ) : [[http://localhost:8000/doc/live/reference/sage/misc/lazy_format.html]]
  1. apres "Here are two corner cases:", l'exemple n'est pas interprete : [[http://localhost:8000/doc/live/reference/sage/misc/functional.html]]
  1. 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]]
  1. cherchez l'enorme erreur ! : [[http://localhost:8000/doc/live/reference/sage/combinat/combinat.html]]
  1. dans les methodes FibonacciTree et HoffmanSingletonGraph, les exemples ne sont pas interpretes : [[http://localhost:8000/doc/live/reference/sage/graphs/graph_generators.html]]
  1. il manque : apres le mot EXAMPLE : [[http://localhost:8000/doc/live/reference/sage/combinat/kazhdan_lusztig.html]]
  1. dans certaines methodes (a lister), il manque : apres le mot EXAMPLE et aussi certains exemples ne sont pas interpretes : [[http://localhost:8000/doc/live/reference/sage/algebras/iwahori_hecke_algebra.html]]
  1. dans la methode is_interval, les : apres AUTHOR devraient etre colles : [[http://localhost:8000/doc/live/reference/sage/graphs/generic_graph.html]]
  1. pas de point dans le titre : [[http://localhost:8000/doc/live/reference/sage/plot/plot3d/base.html]]
  1. example mal formatte : [[http://localhost:8000/doc/live/reference/sage/calculus/riemann.html]]
  1. pas de point dans le titre : [[http://localhost:8000/doc/live/reference/sage/structure/category_object.html]]
  1. pas de point dans le titre : [[http://localhost:8000/doc/live/reference/sage/calculus/functional.html]]


=== Du rab ===
Si ca 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 fonctionalites, dans ce cas, remplacez "defect" par "enhancement".



== Avant le café, gagner du temps pour le prochain expose ==
# sage -clone brouillon

shoutbox = bouton feu rouge pieton ?

Creer un compte sur le serveur trac

http://trac.sagemath.org/sage_trac/ (lien Register en haut a droite).

habituellement, login = premiere lettre du prenom + nom (exemple 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

Remarque: un ticket ne doit pas representer une tache insurmontable (ex: "Please could you implement species")

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 numerotee 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 probleme !

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 se faire les dents, ces tickets sont listes separement dans le "View tickets")
  • Priority: minor
  • Summary: fix documentation in ... <- boulot

  • Component: documentation
  • Description: ..... <- boulot

  • cc: sage-combinat, tmonteil, moi-meme (et en general les personnes dont on espere qu'elles feront quelque chose (fix ou rewiew)).

Remarque: tous ces champs peuvent etre modifies a tout moment, et a chaque changement, les personnes mises en cc recevront un mail.

Remarque: les champs restants (author, reviewer,...) se rempliront au fil du temps.

Liste des bugs a reporter

  1. un point dans le titre en trop en haut : http://localhost:8000/doc/live/reference/sage/calculus/calculus.html

  2. un bloc d'exemple n'est pas interactif : http://localhost:8000/doc/live/reference/sage/combinat/cartesian_product.html

  3. dans la methode fatter, mettre les O(size(n)) en expression math : http://localhost:8000/doc/live/reference/sage/combinat/composition.html

  4. dans la methode keys(), l'exemple n'est pas compris comme tel : http://localhost:8000/doc/live/reference/sage/combinat/finite_class.html

  5. 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

  6. 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

  7. dans Dynamic classes, ..topic: non-interprete : http://localhost:8000/doc/live/reference/sage/structure/dynamic_class.html

  8. 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

  9. apres "This behavior can induce major performance penalties when testing. Note that this issue does not impact the usual assert:", l'exemple n'est pas interprete (il manque probablement un :: ) : http://localhost:8000/doc/live/reference/sage/misc/lazy_format.html

  10. apres "Here are two corner cases:", l'exemple n'est pas interprete : http://localhost:8000/doc/live/reference/sage/misc/functional.html

  11. 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

  12. cherchez l'enorme erreur ! : http://localhost:8000/doc/live/reference/sage/combinat/combinat.html

  13. dans les methodes FibonacciTree et HoffmanSingletonGraph, les exemples ne sont pas interpretes : http://localhost:8000/doc/live/reference/sage/graphs/graph_generators.html

  14. il manque : apres le mot EXAMPLE : http://localhost:8000/doc/live/reference/sage/combinat/kazhdan_lusztig.html

  15. dans certaines methodes (a lister), il manque : apres le mot EXAMPLE et aussi certains exemples ne sont pas interpretes : http://localhost:8000/doc/live/reference/sage/algebras/iwahori_hecke_algebra.html

  16. dans la methode is_interval, les : apres AUTHOR devraient etre colles : http://localhost:8000/doc/live/reference/sage/graphs/generic_graph.html

  17. pas de point dans le titre : http://localhost:8000/doc/live/reference/sage/plot/plot3d/base.html

  18. example mal formatte : http://localhost:8000/doc/live/reference/sage/calculus/riemann.html

  19. pas de point dans le titre : http://localhost:8000/doc/live/reference/sage/structure/category_object.html

  20. pas de point dans le titre : http://localhost:8000/doc/live/reference/sage/calculus/functional.html

Du rab

Si ca 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 fonctionalites, dans ce cas, remplacez "defect" par "enhancement".

Avant le café, gagner du temps pour le prochain expose

# sage -clone brouillon

days28-bugs_to_report (last edited 2019-11-15 19:55:10 by chapoton)