What we're about

Nous aimons créer de la documentation pour des projets de recherche, universitaires, open source et commerciaux. Nous sommes des designers, développeur·se·s, chercheur·se·s, universitaires, professionnel·le·s de la formation et des auteurices techniques. Rejoignez ce meetup pour apprendre et partager ensemble des pratiques, techniques et expériences d'écriture avec un public respectueux.

Code de conduite

(en cours de traduction)

Write the Docs is a global community of documentarians who share information, discuss ideas, and work together to improve the art and science of documentation. Everybody who participates in our community in one way or another is required to conform to our Code of Conduct (https://www.writethedocs.org/code-of-conduct/) (CoC). This includes online communications, meetup and conference attendees, speakers, sponsors, founders, moderators, organisers and volunteers.

Our Code of Conduct applies to all spaces and events relating to this meetup. We strongly recommend you to read the full Code of Conduct, but for your convenience, our key principles are:
- Be friendly and patient.
- Be welcoming. We strive to be a community that welcomes and supports people of all backgrounds and identities. This includes, but is not limited to members of any race, ethnicity, culture, national origin, color, immigration status, social and economic class, educational level, sex, sexual orientation, gender identity and expression, age, size, family status, political belief, religion, and mental and physical ability.

- Be considerate. Your work will be used by other people, and you in turn will depend on the work of others. Any decision you take will affect users and colleagues, and you should take those consequences into account when making decisions. Remember that we’re a world-wide community, so you might not be communicating in someone else’s primary language.

- Be respectful. Not all of us will agree all the time, but disagreement is no excuse for poor behavior and poor manners. We might all experience some frustration now and then, but we cannot allow that frustration to turn into a personal attack. It’s important to remember that a community where people feel uncomfortable or threatened is not a productive one. Members of the Write the Docs community should be respectful when dealing with other members as well as with people outside the community.

- Be careful in the words that you choose. We are a community of professionals, and we conduct ourselves professionally. Be kind to others. Do not insult or put down other participants, individually or as a group. Harassment and other exclusionary behavior aren’t acceptable.

If a Code of Conduct incident happens that affects you, or witness it affecting someone else, please contact the meetup organisers immediately. If you feel uncomfortable with this, if you feel the incident was not well handled by the local organisers, or if you are a meetup organiser and would like to ask for input, you can also email conduct@writethedocs.org. Further details can be found in the Guidelines for reporting incidents (http://www.writethedocs.org/code-of-conduct/#coc-reporting).

Upcoming events (1)

Première rencontre WriteTheDocs Paris le 13 juin après-midi chez Mozilla

WriteTheDocs est une communauté mondiale de personnes attentives à la documentation. Si vous êtes programmeur ou rédacteur technique, dans une équipe de support utilisateurs ou même simple curieux de la façon dont la documentation logicielle peut aider à améliorer l'expérience des utilisateurs, vous êtes au bon endroit ! Vous trouverez de nombreuses ressources sur le site principal : https://www.writethedocs.org Nous sommes trois à lancer ces rencontres WriteTheDocs en France parce que nous aimons la documentation, que nous y voyons un enjeu important pour le développement et la maintenance des logiciels et que nous avons beaucoup à apprendre de l'expérience des autres dans ce domaine. Pour cette première rencontre, nous vous proposons de prendre notre temps et de nous réunir **l'après-midi du 13 juin, de 14h à 18h**. Mozilla a gentiment accepté d'accueillir cette première rencontre. Nous proposons que l'après-midi se déroule en trois temps : 1. un premier temps avec une poignée de présentations classiques de 10 minutes chacune, avec au moins cinq minutes de questions et réponses ; 1.1 **Tomomi Sasaki** (http://blog.ripplet.org) : S/he who conquers documentation, conquers ___: Three lessons I learned in corporate Japan « It’s a play on the Japanese business expression “he who conquers meeting notes, conquers the meeting” which, now that I think about it, has a big impact on how I understand the essence of documenting. That story would be one of the lessons, I’ll choose two more smaller ones, and find a way to tie it together in a future forward way. » 1.2 **Julie Blanc** (http://julie-blanc.fr) : Paginer le flux Présentation de Paged.js, un outil pour transformer une page web (en flux) en document paginé imprimable. Où comment transformer sa documentation en objet physique (livre, magazine) en restant dans un environnement Web, sans avoir recours à un logiciel comme InDesign & cie. 1.3 **Julien Palard** (https://mdk.fr) : La traduction de la documentation de Python « Je vous parlerai du projet de traduction de la documentation de Python, environ un million de mots dans 17 langues : comment on en est arrivé là, comment on s'organise, comment on s'outille, comment on communique, ce qu'on fait bien, ce qu'on fait mal, ce qu'on aimerait changer (spoiler : le monde), et pourquoi on le fait ? » 2. un deuxième temps autour de deux projets dans un format s'inspirant de la méthode « accélérateur de projets » (http://moustic.info/2013/wakka.php?wiki=AccelerateurProjet) : une personne présente une idée et les autres interagissent avec elle en aidant à clarifier le problème et les possibles actions à suivre. 2.1 Le questionnement d'**Elifsu Sabuncu** : « Mettre en place et alimenter une base de documentation pour les Sciences Humaines et Sociales (SHS) quand on ne vous a rien demandé et qu'on n'y connait rien en code ? » 2.2 Annonce bientôt… 3. échanges libres — discussions, expérimentations, contributions en direct sur des projets de documentation, etc. Nous voulons aussi profiter de cette rencontre pour réfléchir ensemble à la suite. Nous avons initié ces échanges mais souhaitons que chacun puisse être organisateur des prochaines rencontres, sur une fréquence à déterminer. Et surtout : parlons documentation, et venez nombreux !

Photos (2)