conf pyconfr

Bio
===

Benoît est du genre à se poser des tas de questions, alors il aime bien les outils qui l'aident à rester pragmatique.


PEP 423 : nommage et packaging
==============================

Les noms de projets sur PyPI, c'est-y pas un peu le bazar ? Y a-t-il des recettes pour choisir un "bon" nom de projet ? Y a-t-il des pièges à éviter ? Ces questions ont motivé la PEP 423. laquelle est actuellement en discussion. Cette présentation essaiera d'apporter quelques éléments de réponse à partir de la PEP et des discussions qu'elle aura suscité.


- Statut de la PEP 423
- Conventions de nommage
- Qu'est-ce qu'un "bon" nom de projet ?
- Pièges à éviter
- Trucs et astuces

Le contenu de la PEP au 6 juillet 2012 est vraisemblablement amené à sensiblement changer, rapport aux discussions sur python-dev@python.org ou distutils-sig@python.org.

Références :

- La [PEP 423](http://www.python.org/dev/peps/pep-0423/) (draft !)
- [discussions sur distutils-sig@python.org en mai](http://mail.python.org/pipermail/distutils-sig/2012-May/018551.html) et [la suite en juin](http://mail.python.org/pipermail/distutils-sig/2012-June/018641.html)
- [discussion sur python-dev@python.org](http://thread.gmane.org/gmane.comp.python.devel/133950)


Je pense faire en sorte que la présentation en elle-même ne dure pas 30 minutes : je doute que j'arrive à captiver l'attention du public sur ce sujet pendant 30 minutes. 15-20 minutes grand maximum AMHA. Voire moins.
=> un lightning-talk ?

Par contre, il est possible que ça discute/trolle après la présentation, surtout si la PEP n'a pas, à la date de PyCon FR, réussi à trouver la voie du consensus.

J'ai indiqué niveau "moyen" car je suppose que le sujet sera plus parlant pour les gens qui ont au moins une vague idée de ce qu'est le packaging. Ceci dit, je pense que les débutants pourront suivre sans souci.


Valorisez votre documentation
=============================

Rédiger une documentation efficace est un exercice difficile. La maintenir, c'est pire. Cette conférence illustrera des problématiques liées à la documentation de projets au travers de cas d'utilisation et de recettes pour Sphinx.

Références :

- [bonnes pratiques de documentation]http://documentation-best-practices.readthedocs.org/
- [Conventions de codage pour Sphinx](http://documentation-style-guide-sphinx.readthedocs.org/)


Je peux certainement faire tenir la présentation en elle-même (sans les questions) dans un slot de 15-20 minutes. En fait, ce serait ma préférence si j'avais le choix ;)

La présentation sera aussi un moyen d'obtenir du feedback (voire de recruter des contributeurs) sur les projets cités en référence.