On nous annonce la venue prochaine de Netflix en France, service de streaming de films qui fait déjà trembler les professionnels de la profession (qui n’ont pas jusque là réussi à se mettre d’accord pour propose une offre légale cohérente et mutualisée).

Les « pirates » s’en fichent, ils ont Popcorn Time, qualifiée ici de « pire cauchemar d’Hollywood ».

Voici en tout cas un outil (libre et) intéressant pour partager par torrents et lire à la volée de la vidéo sur Internet. Ce qui ne dit rien sur la licence de ces vidéos qui peuvent très bien être libres ou dans le domaine public, réglant alors la question des « pirates » qui n’existent plus.

Edit : Quelques jours plus tard, les développeurs fermaient soudainement le site et stoppaient leur travail ! Mais puisque c’est libre, l’application est déjà reprise par d’autres !!!

Popcorn Time : un « Netflix » open source de torrents pour pirates

Popcorn Time: Open Source Torrent Streaming Netflix for Pirates

Ernesto - 8 mars 2014 - TorrentFreak
(Traduction : ilo, Juliette, Kcchouette, aKa, lumi, Diab, Diin, loicwood, Amazigh, Alexis Ids, mokas01 + anonymes)

Popcorn Time, une application de streaming vidéo multi-plateforme et bénéficiant de la technologie BitTorrent, pourrait très bien se révéler être le pire cauchemar d’Hollywood. Le logiciel peut être décrit comme un Netflix pour pirates, permettant aux utilisateurs de diffuser les derniers grand succès sans frais. TorrentFreak s’est entretenu avec l’un des développeurs pour savoir comment l’application est née.

Au fil des ans, BitTorrent est devenu assez grand public, avec des centaines de millions de personnes utilisant des clients de torrent pour télécharger les derniers divertissements.

Malgré sa popularité, le processus de téléchargement peut se révéler ardu, particulièrement pour les novices. Confronté à ce problème, Sebastian, un designer de Buenos Aires, a décidé de concevoir un logiciel qui simplifie la manipulation et la rend aussi simple que Netflix.

« En tant que designer j’aime simplifier les choses. Prendre quelque chose de complexe et le rendre accessible pour l’utilisateur lambda. J’ai beaucoup d’amis qui ne comprennent pas comment fonctionnent les torrents et je voulais rendre l’usage de la technologie torrent facile et sans effort », nous dit Sebastian

Après quelques mois de code, Popcorn Time était né, un outil qui permet aux utilisateurs de diffuser des torrents de films populaires en un simple clic. Popcorn Time offre un accès immédiat à des centaines de films, disponibles en différentes qualités et sous-titrés si besoin.

Ce qui a débuté comme l’expérimentation d’un groupe d’amis s’est bientôt transforméen quelque chose de bien plus important. Popcorn Time a maintenant 20 collaborateurs sur Github et continue de se développer très rapidement. Des développeurs du monde entier ont ainsi ajouté de nouvelles caractéristiques et, en l’espace de 24 heures, l’application était traduite en six langues différentes.

Sebastian explique que Popcorn Time utilise node-webkit et est disponible sous Windows, Mac et Linux. Il s’agit d’un navigateur qui utilise HTML, CSS et JavaScript pour fournir les flux de films.

« La technologie utilisée pour l’appli et très simple. Nous utilisons un groupe d’APIs, une pour les torrents, une autre pour l’info du film, et une autre pour l’image de l’affiche du film. Nous avons aussi une API pour les sous-titres. Tout est automatisé, nous n’hébergeons rien, mais nous prenons les informations existantes pour les relier », explique Sebastian.

Les fichiers torrents viennent tous de YTS (anciennement YIFY), qui possède une API exploitée par Popcorn Time. L’application peut chercher dans sa base de données et autorise les utilisateurs à streamer le torrent à la demande. À la fin, l’appli continuera à partager pendant un moment, après que le téléchargement soit terminé, pour éviter le leeching.

Considérant que Popcorn mène à un grand nombre de films sous copyright, l’industrie culturelle risque de ne pas être contente mais si l’on en croit Sebastian, les développeurs ne s’attendent pas à des problèmes juridiques. Ils informent ainsi en page d’accueil les utilisateurs que « le téléchargement de films sous copyright peut ne pas autorisé dans votre pays ». Par ailleurs, ils ne font qu’intégrer du contenu déjà existant, et ce sans visée commerciale.

« Nous ne prévoyons pas de problèmes judiciaires; nous n’hébergeons rien, et aucun des développeurs ne se fait d’argent là-dessus. Il n’y a pas de publicités, pas de comptes premium, et aucun frais d’abonnement ou quoi que ce soit d’autre. C’est une aventure-expérience pour apprendre et partager », souligne Sebastian.

Toutes les personnes travaillant sur ce projet sont elles-mêmes de grands fans de films, et la plupart ont un compte Netflix. Sebastian reste convaincu qu’aller au cinéma est la meilleure façon de profiter d’un film, mais si des gens veulent regarder un film récent à la maison, ils devraient pouvoir le faire. Souvent, ce n’est pas le cas, et c’est là où Popcorn Time entre en jeu.

« Nous déplorons de ne pas avoir l’opportunité de regarder certains films à la maison. Popcorn Time est une expérimentation dont le but est de montrer que l’on peut faire mieux pour les utilisateurs, et ce, avec BitTorrent », dit Sebastian.

Popcorn Time est officiellement toujours en Bêta, et va continuer de s’améliorer au cours des semaines et mois à venir. Toutefois, une chose ne changera jamais, il restera libre et open source aussi longtemps qu’il existera.

Le site OpenWatch nous propose de faire du journalisme autrement en s’inspirant des principes et techniques du logiciel libre.

Ils appellent cela le « journalisme open source » et y voient, non sans emphase, l’avenir de la profession.

Pure rhétorique ou réelles pistes à explorer pour un secteur en grave difficulté actuellement ?

Les nouveaux principes du journalisme open source

The New Principles of Open Source Journalism

(Traduction : Peekmo, goofy, lamessen, Slamino, Omegax„ Asta, Paul, Kayjin, aKa + anonymes)

OpenWatch souhaite être le cœur du journalisme open source de la prochaine décennie. Quelles valeurs émergeront pour définir les actualités de demain ?

Partout dans le monde, les agences de presse traditionnelles vacillent. Leurs revenus publicitaires se tarissent car les gens suivent de plus en plus l’actualité à partir de sources d’information en ligne ou ne s’y intéressent tout simplement pas parce qu’ils préfèrent consacrer leur temps à d’autres types de contenus numériques. L’information qui reste est plus édulcorée que jamais, le journalisme d’investigation a laissé la place à des opérations de relations publiques travesties en information, les correspondants à l’étranger sont remplacés par des vidéos virales et des ragots people.

Pourtant, le journalisme joue un rôle terriblement important dans la société, en permettant aux gens d’être informés sur le monde qui les entoure et en obligeant les élites au pouvoir à rendre compte de leurs actes. Nous ne pouvons laisser ce rôle simplement passer à la trappe. Au lieu de vivre cette situation comme une catastrophe, nous pouvons y voir une opportunité de réévaluer la nature et l’objet du journalisme. Partant de là, je crois pouvoir dire que nous assistons à l’émergence du phénomène peut-être le plus réussi et étrangement merveilleux de l’ère numérique : le mouvement du logiciel et de la culture « libres et open source ». Dans ce mouvement, les individus sont libres de consommer l’information et d’y contribuer au sein d’un espace commun et, ensemble, ils sont parvenus à créer un tout qui est plus que la somme de ses parties.

OpenWatch est une entreprise du secteur des technologies qui produit et soutient le journalisme open source. OpenWatch vise à être au New York Times ce que RedHat est à IBM. Notre produit de base est une suite gratuite d’applications mobiles qui permet à n’importe qui de diffuser du contenu, de visionner des vidéos sur téléphone mobile et de recevoir des alertes avec des possibilités de contribuer à nos reportages et enquêtes.

Du point de vue éditorial, nous sommes intéressés par la couverture des sujets sous-médiatisés tels ceux tirés d’histoires et d’enregistrements de gens ordinaires, mais aussi par les événements où les médias traditionnels échouent à remettre en cause les pouvoirs établis. Nous souhaitons présenter nos articles dans un contexte où l’homme de la rue peut prendre part à la mise au jour et à l’exposition de faits vérifiés.

Histoire

Au fil des ans, il y a eu bon nombre de tentatives de qualifier le genre de travail que nous évoquons ici : journalisme citoyen, journalisme civique, journalisme participatif, journalisme scientifique, journalisme (ouvert au) public, journalisme collaboratif, journalisme communautaire, wiki-journalisme et une foultitude d’autres appellations qui, j’en suis sûr, doivent exister.

Chez nous, nous appelons cela simplement du « journalisme open source ». En tant que contributeurs au mouvement du logiciel libre et open source, nous sommes bien conscients que le terme « open » peut être à la fois chargé et vide de sens. Nous souhaitons donc esquisser quelques principes de base qui, selon nous, définiront le journalisme open source de la décennie à venir.

Il ne s’agit ni d’un manifeste, ni d’une liste de revendications, ni même d’une promesse. C’est simplement une liste de valeurs journalistiques que nous entendons respecter et promouvoir. Nous ne voulons pas être crédités pour ces principes : d’autres, nombreux, nous ont précédés, existent à nos côtés ou viendront après nous. Notre seule ambition est d’exposer ces principes et d’inviter d’autres à les partager.

Avec le temps, nous espérons que l’importance de ces valeurs deviendra si évidente qu’elles feront apparaître le journalisme traditionnel comme dépassé et influenceront les grands organes de la presse traditionnelle.

1. Des sources primaires complètes

Le principe premier du journalisme open source est qu’il doit être « scientifique ». Cela signifie donner un accès aux sources primaires complètes, sous la forme de matériel documentaire associé, par un lien ou une incorporation, aux affirmations du récit journalistique, y compris tous les entretiens oraux ou par courriel avec des individus ou les documents bruts pour les sources anonymes.

Sans sources primaires complètes, le public est en réalité réduit à l’impuissance, privé de la possibilité de vérifier la véracité des faits qui lui sont livrés et se trouve réduit à devoir faire confiance à une seule version des faits. Avec la confiance vient le pouvoir, et avec le pouvoir viennent les abus. Le public a été gravement abusé sur de nombreuses questions, par exemple dans l’exposition des faits justifiant la guerre contre l’Irak, dans la couverture du programme d’assassinats par des drones, dans les allégations d’utilisation d’armes chimiques en Syrie et, aujourd’hui, avec le programme de surveillance de la NSA.

Le journalisme scientifique, pour sa part, ne requiert pas autant de confiance dès lors que le lecteur possède autant d’informations que le journaliste qui l’informe.

En fin de compte, cela signifie l’abandon du « scoop » et des sources non attribuées, qui, de par leur nature, voilent le mécanisme qui transforme les faits en analyse. À leur place, nous proposons un sommaire transparent, une contextualisation, un remixage et une analyse complètes des sources primaires.

2. Pratique et Participatif

Dans le journalisme open source, l’action est plus importante que le contenu. L’objectif du journalisme open source n’est pas de divertir, ni même de simplement informer, mais plutôt de tenter de construire un projet de changement. Ce projet doit commencer par les faits déjà connus, mais devrait aussi fournir une feuille de route décrivant les inconnues référencées et ce qui sera nécessaire pour répondre à ces questions. Les lecteurs soucieux des erreurs devraient avoir l’opportunité d’être directement impliqués dans le processus de collecte, de traitement, de synthèse et de publication des actualités. Mais ce n’est pas tout. Le but de notre journalisme est aussi de défier, provoquer et demander des réponses aux pouvoirs établis. Et aussi longtemps que ce sera fait de façon productive et documentée, ce sera quelque chose dans lequel le public devrait être impliqué.

Les projets de logiciels open source utilisent ordinairement un outil de « bugs » et de « tickets » pour suivre et accélérer leur développement ; chez OpenWatch, nous les appelons « missions ». Vous pouvez parcourir la liste de toutes nos missions actuellement actives ici pour pouvoir contribuer à nos investigations en cours.

Au final, nous espérons créer une force globale et répartie de fouineurs et une place centrale d’idées concrètes au sujet des problèmes importants.

3. Garanties

Historiquement, un des plus gros défis pour les médias et reportages citoyens est la question de l’authenticité. Il est souvent difficile de déterminer si les médias et l’information proposés en ligne sont authentiques ou s’ils sont le produit de quelqu’un désireux de promouvoir une cause, d’une partie adverse essayant de saboter une histoire ou simplement d’un « troll » ennuyeux. Les plateformes comme Youtube, Facebook et Twitter ne fournissent aucun outil automatique d’expertise de l’authenticité ; réceptacles par essence d’un flux continu d’informations éphémères, qui se combine à la capacité d’amplifier rapidement certains messages, elles sont souvent exploitées à des fins de diffusion de canulars et de désinformation (comme l’illustre le cas récent de ces images de manifestations en Turquie filmées en réalité plus tôt dans l’année à l’occasion d’un marathon).

Pour lutter contre ce problème, OpenWatch utilise un bouquet de technologies destinées à faciliter la vérification de l’authenticité d’un média dans notre système. Une de ces technologies est un système que nous appelons CitizenMediaNotary. Inspiré par le projet Perspectives, CitizenMediaNotary est un réseau de serveurs de confiance distribué, qui maintient une base de données d’empreintes digitales des médias citoyens. Cela permet de savoir si un contenu est vraiment nouveau ou s’il a déjà été visionné auparavant et, dans ce cas, où, quand et par qui.

4. Prévoir

Si nous ne couvrons que les atrocités passées, nous ne serons jamais en mesure de les prévenir. Le journalisme d’avant a presque exclusivement porté sur des événements qui ont déjà eu lieu, et c’est une occasion majeure manquée pour l’émancipation.

La participation des foules sera un facteur majeur dans le futur du journalisme de prévision, dans la mesure où de grands ensembles de données sont bien meilleurs pour les prévisions que les petits. Par exemple, à l’époque où OpenWatch était un service exclusivement utilisé pour surveiller l’action de la police, nous étions capables d’analyser des modèles d’action trouvés dans nos données pour réaliser des prévisions plus précises sur les régions où des abus policiers avaient plus de chance d’avoir lieu et ce n’est que le début. Dans le futur, nous pourrons collecter des jeux de données multisourcés et publics de manière à prédire quelle communauté à risque est susceptible d’être frappée par une catastrophe naturelle, qui sera le gagnant d’une élection, le résultat probable d’une décision de justice, quelles écoles seront fermées par une nouvelle administration et bien d’autres choses encore.

On assiste ces derniers temps a une augmentation notable de la production de rapports prévisionnels grâce à des agences privées du renseignement comme Stratfor, mais cette activité de prévision est onéreuse et sa commercialisation uniquement orientée vers les pouvoirs établis, qui bénéficient déjà du système actuel. OpenWatch s’efforce de fournir le même genre d’informations spécialisées, mais avec un accès ouvert à tous et avec une position résolument critique et orientée par l’intérêt public.

Bien sûr, nous ne pourrons en rien garantir le degré d’exactitude de nos prévisions, mais du fait que tous nos rapports sont totalement open source, les lecteurs sont les bienvenus pour produire et donner également leur propres prédictions.

5. Transparence éditoriale

La démarche open source et participative appliquée à l’ensemble de nos publications vaut aussi pour notre démarche éditoriale. Le public en général et notre lectorat en particulier jouissent ainsi d’un accès direct à l’ensemble du processus décisionnel au sein d’OpenWatch, qu’ils souhaitent en être témoins ou y prendre part. Cela permet au lectorat en général grand public d’assister directement la totalité du processus décisionnel d’OpenWatch, aussi bien que d’y être impliqué.

Comme il se doit en open source, cette démarche éditoriale repose sur des listes de diffusion publiques. Nous appelons ce système « Radar » car il n’offre pas seulement un aperçu des événements en cours de traitement chez OpenWatch, il est aussi un calendrier dynamique des événements que nous avons l’intention de couvrir.

Si vous souhaitez voir ce qui se trame sous le capot d’OpenWatch ou avoir votre mot à dire sur la manière dont OpenWatch gère ses ressources éditoriales, rejoignez notre liste de discussion publique en envoyant un courriel à openwatch-radar@googlegroups.com, vous serez immédiatement inscrit-e (les hackeurs sont aussi invités à rejoindre la liste openwatch-dev@googlegroups.com pour participer aux discussions autour des développements techniques).

Nous ne prétendons pas qu’un tel niveau de participation est nécessaire pour tous les canaux d’information open source, le degré de participation proposé dans certains groupes pouvant être moindre que le nôtre pour une raison ou une autre, mais il est important dans tous les cas, que les décisions éditoriales émanent d’un noyau privé, d’un noyau public ou d’un consensus public, que le cadre décisionnel soit transparent.

6. Gestion des versions

Git est un outil qui permet aux développeurs et aux utilisateurs de logiciels libres de garder la trace de l’ensemble de leurs changements, de voir qui contribue à quelle partie d’un projet et de revenir à l’état antérieur d’un projet en cas de catastrophe. C’est un logiciel absolument crucial. Les utilisateurs réguliers de Wikipédia sont habitués à des outils de contrôle des versions aux fonctionnalités similaires (via la page Historique d’un article)

Néanmoins, aussi précieux qu’il soit, le contrôle des versions est rarement pratiqué dans d’autres secteurs que celui du développement logiciel. De manière intéressante, dans le domaine du journalisme, le contrôle des versions peut apporter quelque chose que l’inventeur de git n’avait jamais imaginé : la résistance à la censure cachée.

Contrairement aux apparences, certaines formes de censure sont plus aisées à mettre en œuvre dans le royaume numérique que dans le monde physique. Dans le monde physique, le censeur laisse une trace : un trait noir, un nom effacé, des autocollants, des agrafes, de la colle. Sur l’internet, nulles preuves semblables d’une censure post-publication : seulement un article qui disparaît ou un léger changement de contenu, sans que personne n’en sache rien.

Un nouveau projet, Newsdiffs, tente de traquer les changements en tant que service proposé à une poignée d’organes d’information traditionnels. Cet effort mérite nos applaudissements, mais la solution est actuellement limitée et laisse beaucoup de changements passer au travers des mailles du filet. Dans le futur, nous aimerions voir davantage d’organisations prendre elles-mêmes cette responsabilité à travers une combinaison de contrôle interne et tiers de tout le contenu des actualités.

7. Permanence

Les journaux et la télévision sont des formats éphémères. Un journal se jette, une diffusion télévisée n’est pas enregistrée. Internet, par contre, n’oublie jamais. Un article n’existe pas seulement pour un jour, il existera pour le restant de l’histoire enregistrée et sera toujours à la portée d’une simple recherche, accessible en une seconde.

Par conséquent, on doit envisager que les articles seront toujours accessibles dans un lointain futur et doivent être créés en ayant à l’esprit les lecteurs du futur, qui devront à leur tour pouvoir y apporter leur contribution.

8. Logiciel libre, contenu libre

En dernier lieu, nous pouvons incorporer les principes du logiciel libre et de la culture libre dans le journalisme open source. Fondamentalement, cela signifie que nous devons respecter les droits digitaux de nos utilisateurs et utiliser autant de logiciels libres et open source que possible, en nous assurant que le contenu est produit sous une licence permissive ou copyleft, en traquant le moins possible les utilisateurs et en leur permettant de savoir comment et pourquoi nous les traquons.

Les principes de la culture libre sont nécessaires pour n’importe quel projet ouvert et participatif car c’est grâce à eux que les communautés en ligne ont la capacité de réaliser ces choses formidables qui les rendent très différentes des organes de presse traditionnels.

Il devient concevable non seulement de lier, partager et traduire librement l’information (la traduction étant une autre question gérée de manière insatisfaisante dans les médias d’information traditionnels), mais aussi de remixer les contenus et de présenter les médias et analyses sous des formes nouvelles, que leur auteur originel n’aurait éventuellement pas imaginé.

En définitive, le journalisme open source ne doit pas recourir au droit d’accès payant comme source de revenus car c’est en totale contradiction avec la volonté de produire du contenu dans le but d’informer et de donner au public le pouvoir de l’autonomie et de la responsabilité. Faute de proposer à ce dernier un libre accès aux informations d’importance, cela ne serait en fin de compte guère plus qu’une extorsion de fonds. Il existe plein d’autres modèles économiques de soutien du logiciel libre qui peuvent tout aussi bien soutenir le journalisme open source (nous reviendrons dessus plus en détail dans un autre billet).

En avant !

Nous vous avons décrit quelques-unes des valeurs centrales dont OpenWatch entend imprégner sa forme de journalisme open source. Si vous souhaitez contribuer à documenter la vérité et résister aux pouvoirs adeptes du secret, rejoignez-nous ! Nous ne savons pas exactement où cela nous mènera, mais nous sommes certains qu’unis dans la quête de la vérité, nous pouvons construire quelque chose de vraiment étonnant et bien pour tous. Rejoignez-nous !

Crédit photo : Decar66 (Creative Commons By)

Il y a un peu moins d’un an nous faisions le constat que Framapad était de plus en plus souvent utilisé dans l’éducation. En illustrant cela avec, entre autres, un billet sur l’expérience de Frédéric Véron, professeur de SVT dans l’Académie de Créteil.

Il nous propose ici, merci à lui, 3 tutoriels vidéos récemment mis en ligne.

Découverte et utilisation de Framapad (pads publics)

Comparaison et avantages de la création d’un compte (pads privés)

Attention : La création de compte risque d’être bientôt suspendue parce que non maintenue, nous vous invitons plutôt à utiliser les pads publics.

Exemple de travail collaboratif avec des élèves de Sixième

Sources :

• GnuTLS sur Wikipédia
• Le fail de GnuTLS sur Numerama
• Le fail d'Apple sur Numerama

Crédit : Simon Gee Giraudot (Creative Commons By-Sa)

L’équipe d’OpenHatch organise régulièrement des rencontres, ateliers, événements, sprints, hackathons, etc. invitant de nouveaux contributeurs à participer au développement de logiciels libres. Elle nous livre ici le fruit de son expérience.

L’enthousiasme et la motivation sont indispensables mais ne peuvent faire l’économie d’une solide organisation et réflexion en amont. Happy Hacking :)

Note : On remarquera que les deux livres cités en référence pour aller plus loin font partie de nos traduction Framabook : Libres conseils et Produire du logiciel libre.

Le guide de l’événement libre in situ

The In-Person Event Handbook

L’équipe OpenHatch - février 2014
(Traduction : Omegax, zak, François, Jean-Marc Gailis, Ju, MrTino, Wan, Asta, François, goofy, amha)

Faire en sorte que votre projet soit prêt pour de nouveaux contributeurs

Il semble que chaque jour apparaisse un nouvel atelier, hackaton ou autre sprint, où des projets open source sont invités à travailler avec de nouveaux contributeurs. À OpenHatch, nous avons nous-mêmes souvent organisé ce genre d’événements ! Nous avons découvert que pour en tirer un profit maximal, il est important de planifier les choses en amont. Expliquer vos objectifs, identifier les tâches appropriées, et tester l’organisation de votre projet sont autant de points indispensables pour aboutir à de belles réalisations et passer un bon moment. Ce travail a grandement amélioré nos expériences, et nous pensons qu’il mérite l’effort significatif qu’il mplique.

Nous avons créé ce guide pour aider les projets open source à se préparer pour ces événements. Nous avons utilisé notre propre projet, l’application web OpenHatch.org, comme un exemple dans ce qui suit. Au bas de la page, vous trouverez des aide-mémoires. Elles contiennent en condensé les conseils dispensés dans ce guide, et peuvent vous aider à monitorer vos progrès durant la phase de préparation de votre projet.

Les sources de ce guide sont libres. Un tas de merci à nos contributeurs. (Vous pouvez contribuer, vous aussi !)

Définir des objectifs

Vous devez être capable de présenter clairement vos objectifs pour l’événement, car cela donne à votre groupe une ambition générale à atteindre. Vous pouvez donc commencer par vous demander :

Quel est l’objectif global de votre projet ?

Il vous faut une réponse courte (un paragraphe ou moins) à cette question que vous pourrez utiliser pour attirer les contributeurs potentiels vers votre projet. Les détails, c’est bien joli, mais vous ne devriez pas avoir besoin d’être trop technique à ce moment là. À de nombreux événements, comme les sprints PyCon, on vous demandera un court résumé à exposer devant tout le monde. Pourquoi ne pas vous y préparer ?

Exemple :

L’objectif de OpenHatch est de rendre les communautés de logiciels libres plus accueillantes pour les nouveaux venus. Pour ce faire, nous fournissons documents et support logistique pour animer des ateliers « Introduction à l’open source », un site web avec des ressources libres, des « missions d’entraînement », un découvreur de talents parmi les bénévoles, et plusieurs autres projets en cours de réalisation.

Que voulez-vous accomplir à cet événement ?

Réfléchissez à ce que vous souhaitez voir spécifiquement réalisé lors de cet événement. Vous pouvez catégoriser ces objectifs selon les différentes parties du projet, si vous en avez plusieurs. Il devrait être spécifié clairement de quelle manière ces actions contribueront au progrès général du projet. Toutefois, il ne s’agit pas de « tâches » — il devrait être toujours nécessaire de diviser ces objectifs pour mieux les atteindre.

Il est utile de les lister en termes d’objectifs « principaux » et « étendus ». Avoir des objectifs principaux réalistes et bien définis vous donne quelque chose à célébrer à la fin de l’événement, tandis que les objectifs étendus ou secondaires vous permettent de prévoir le cas excitant où vous vous retrouviez avec une équipe nombreuse et efficace, capable d’accomplir une tonne de travail.

En général, il vaut mieux avoir trop d’objectifs que pas assez, mais priorisez-les. Lorsque vous arriverez à l’étape du découpage en tâches, prenez le temps de traiter en détail chaque objectif avant de passer au suivant.

Exemple :

• Faire une nouvelle mission d’entraînement
  • Objectif principal : Choisir une compétence sur laquelle baser une nouvelle mission d’entraînement, et concevoir cette mission. En créer une maquette.
  • Objectif étendu : Implémenter la maquette et la faire tester par des volontaires de l’événement.
• Faire le ménage dans le suivi de tickets
  • Objectif principal : Passer en revue l’outil de suivi, et étiqueter les tickets selon le « ménage » à y faire. Un bug doit-il être vérifié ? Un patch doit-il être testé ? Une demande de fonctionnalité doit-elle être être rattachée à un jalon ?
  • Objectif étendu : Utiliser ces étiquettes comme guide pour « faire le ménage » . Vérifier les bugs, tester les patches, etc.

Installation du projet

Dans notre expérience, la phase d’installation du projet est l’obstacle majeur à la participation. Nous avons vu (et conduit !) des événements où les participants passaient le plus clair de leur temps à seulement mettre en place leur environnement de développement et faire connaissance avec le projet. Si notre objectif est de permettre à de nouveaux venus de contribuer, tâchez d’estimer le temps qu’il faut pour installer votre projet. Puis trouvez un ami qui n’est pas familier avec votre projet pour voir combien de temps il faut vraiment. Vous pouvez aussi trouver quelqu’un pour vous aider à faire cela dans #openhatch.

Documenter et améliorer le processus à l’avance peut faire économiser du temps et de l’énergie à tout le monde. Si vous savez qu’une partie de votre projet sera inévitablement dévoreuse de temps, assurez-vous que tous les participants savent exactement à quoi s’en tenir.

Toutes les informations ci-dessous devraient être documentées dans un fichier LISEZ-MOI placé à la racine de votre dépôt. Vous pouvez également placer cette information dans une section « Vous voulez participer ? » sur le site web de votre projet, et/ou vous pouvez inclure un lien vers le LISEZ-MOI dans la signature de votre liste de diffusion ou dans la barre de statut de votre canal IRC.

Comment trouver une communauté et des mainteneurs pour le projet

Les informations des contacts devraient être explicitement affichées, étant donné que vous pourriez avoir des contributeurs éloignés ou des contributeurs qui voudraient démarrer en amont de l’événement. Les types d’informations de contacts peuvent inclure :

• Un lien vers votre mailing-list ;
• Votre nom de canal et de serveur IRC (avec le lien vers le guide pour installer IRC et le lien vers sa version webchat) ;
• Les comptes de réseaux sociaux tels que Identi.ca, Twitter ou Facebook si votre projet en possède ;
• Le contact des mainteneurs du projet, si vous vous sentez à l’aise pour le mentionner.

Si vous avez une préférence pour le type de prise de contact, précisez-le.

Exemple:

OpenHatch laisse en deux endroits des informations de contact que nous essayons le plus possible de garder à jour et en cohérence l’un avec l’autre. Il y a nos informations de contacts dans la documentation, référencées principalement depuis notre répertoire où sont déposés les codes sources, et nos informations de contacts dans le wiki, référencées à partir de la page d’accueil du site web.

La structure du projet

Décrivez la structure de base de votre projet. Quels sont les plus gros composants et où sont-ils situés ? Comment ces composants interagissent-ils ? Puis décomposez chaque partie. Vous n’avez pas à parler de chaque fichier ou sous-dossier de votre projet, mais prenez soin de ne pas prendre pour acquis que chaque nouveau venu comprendra le sens de tel script, ou la manière dont interagissent tels fichiers, ou dans quel langage est programmée telle partie du projet.

Selon la taille et la complexité de votre projet, cela peut être une tâche particulièrement imposante. Chez OpenHatch, nous travaillons toujours à documenter la structure complète du projet. Nous recommandons de commencer par une explication « en vue d’ensemble » de la structure projet - juste assez de détails pour remplir d’une demi-page à une page. Quand vous aurez plus de temps, vous pourrez rentrer dans le détail, en commençant par les parties du projet sur lesquelles les gens travaillent le plus souvent (ou qui sont plus susceptibles de faire l’objet de sprints ou de hackatons). Si vous utilisez d’autres frameworks ou librairies, vous pouvez gagner du temps en mettant des liens vers leur documentation et leurs tutoriels.

Exemple :

Une description d’ensemble de la structure du projet OpenHatch peut être trouvée dans « Project Overview ». Une description de la structure de OH-Mainline (le dépôt derrière notre site web) y est présente.

Comment mettre en place un environnement (« de développement ») local

Pour contribuer à votre projet, les gens ont généralement besoin d’une version locale du projet où ils peuvent faire des modifications et les évaluer. Plus votre guide d’installation/développement est détaillé et clair, mieux c’est.

Voici quelques éléments pour la mise en place d’un environnement de développement à mettre dans votre guide :

• Préparer leur ordinateur
  • Assurez vous qu’ils connaissent bien les outils de leurs systèmes d’exploitation, comme le terminal / la ligne de commande. Vous pouvez le faire en donnant un lien vers un didacticiel et en demandant aux utilisateurs s’ils le comprennent bien. Souvent, de très bons didacticiels existent déjà, celui d’OpenHatch sur la ligne de commande est disponible ici.
  • Si les contributeurs doivent mettre en place un environnement virtualisé, accéder à une machine virtuelle ou installer un kit de développement en particulier, expliquez-leur comment faire.
  • Donnez la liste de toutes les dépendances nécessaires pour faire tourner le projet, et une explication pour les installer. Fournissez un lien vers de bons guides d’installation, s’il en existe.
• Téléchargement du code source
  • Donnez des instructions détaillées sur comment télécharger le code source du projet, dont les obstacles et problèmes fréquemment rencontrés.
  • S’il existe plusieurs versions du projet, dites clairement quelle version ils doivent télécharger.
• Comment voir / tester les changements
  • Expliquer aux contributeurs comment voir et tester les changements qu’ils ont effectués. Ceci peut varier selon ce qu’ils ont changé, mais faites votre possible pour couvrir les changements les plus fréquents. Cela peut être, tout simplement, afficher un document html dans un navigateur, mais ce peut aussi être plus compliqué.

L’installation pourra différer pour chaque contributeur en fonction de leur système d’exploitation. Vous aurez probablement besoin de créer des instructions séparées pour les utilisateurs de Windows, Mac et Linux, dans différentes parties de votre guide. Si vous entendez ne supporter le développement que pour un seul système d’exploitation, assurez-vous que cela soit dit clairement pour les utilisateurs,

Exemple:

Vous pouvez voir comment OpenHatch annonce cela dans son guide d’installation. Les instructions pour tester des changements peuvent être trouvées là. Des tâches plus spécifiques peuvent avoir leur documentation additionnelle (par exemple la documentation concernant les différents changements du code).

Contributions et retours

Comment les contributeurs doivent-ils procéder pour amener leurs modifications au projet ? Est-ce qu’ils soumettent une pull request sur Github ? Doivent-ils générer un patch et l’attacher à un ticket sur le système de tickets ? Assurez-vous que cette information est explicitement fournie.

Example :

Le guide d’OpenHatch pour soumettre des changements peut être trouvé ici.

Il est aussi utile d’indiquer aux gens comment ils peuvent faire des retours/signaler des bugs sur le projet. Si votre projet n’a pas de système de suivi de tickets, envisagez d’en créer un. Sur Github, tous les dépôts disposent du système de tickets (bien que vous ayez à l’activer en allant dans Settings puis Features). Il y a beaucoup d’autres systèmes de suivi de tickets.

Si votre projet est de petite taille, vous pouvez ne pas avoir besoin ou ne pas vouloir de systèmes de suivi de tickets. Aucun problème. Le principal est que les contributeurs sachent comment vous remonter des informations.

Example :

Les problèmes avec le projet « Open Source Comes to Campus » peuvent être signalés ici. La plupart des autres problèmes liés à OpenHatch peuvent être signalés là.

Les outils tels que le suivi de tickets sont très utiles pour communiquer de manière asynchrone. Ce n’est peut-être pas la solution la plus appropriée lors d’un événement physique. Si vous voulez changer les choses pour l’occasion - comme demander aux participants de vous notifier par IRC les liens vers les nouveaux tickets, pour éviter qu’ils ne passent entre les mailles du filet - assurez-vous de leur en parler !

Vérifiez votre documentation

Vérifiez que cette documentation est complète et effective en la testant auprès de personnes qui n’ont pas participé à votre projet auparavant. Pour chaque sytème d’esploitation, trouvez au moins une personne pour lire votre documentation, tenter d’installer, faire et tester des modifications et participer aux différentes modifications du projet (au choix de votre testeur, ces modifications peuvent être des faux changements ou des vraies tâches). Vérifiez que vos testeurs ont des compétences et/ou une expérience similaire à celle des nouveaux arrivants à votre évènement.

Si vous rencontrez des difficultés pour trouver des personnes pour vous aider, essayez la chaine #openhatch sur IRC.

Assurez-vous que tous les problèmes qui surviennent lors de ce processus de vérification soient intégrés à la documentation. Une fois que la documentation a été vérifiée, ajoutez une ligne au début de votre guide pour annoncer ce qui a été vérifié et quand.

Par exemple :

Instructions de l’environnement de développement testées avec succès sur Ubuntu 12.04 (le 03/10/2013), Mac OS X 10.8 (le 01/10/2013) et Windows XP (en janv. 2005). Vous pouvez consulter cette démarche à OpenHatch ici.

Idéalement, vous devriez vérifer que tout fonctionne : installer, faire des modifications, les tester et les intégrer. Si vous n’avez le temps que pour une seule de ces tâches, nous vous recommandons de vérifier l’intallation. Notre expérience nous a appris que c’est sur ce point qu’émergent la plupart des problèmes.

Définir les tâches des participants

Retournons aux objectifs de l’événement dont nous avons parlé dans la première section. Chaque objectif devrait être décomposé en étapes distinctes qui permettront de l’atteindre. Ces étapes sont les tâches à confier aux participants.

Ces tâches devraient inclure un résumé en anglais simple aussi bien que les informations sur la localisation des modifications (par exemple, quels fichiers ou fonctions sont altérés). Nous recommendons d’inclure une liste des compétences nécessaires (par exemple : compétences en design, Python basique) et des outils (par exemple: Développement sur environnement Mac). Il est aussi utile d’inclure le nombre estimé d’heures que la tâche va prendre, d’étiqueter certaines tâches comme plus ou moins importantes, et de marquer où quelle tâche est dépendante d’une autre.

Cela semble représenter beaucoup de travail mais cela devrait aider vos participants à trouver rapidement et facilement les tâches appropriées pour eux. Etant donné que l’un des objectifs principaux d’un événement en personne est de donner une expérience positive aux participants, nous pensons que cela en vaut la peine.

Créer un système pour suivre les tâches

Nous recommandons l’utilisation d’un wiki ou un document de planification similaire pour garder une trace des tâches. OpenHatch dispose d’un navigateur pour suivre les tâches que nous utilisons pour nos événements. Vous pouvez, si vous le souhaitez, faire un fork et l’adapter à votre projet ou événement ; cependant, nous vous recommandons d’attendre un peu, car nous allons bientôt faire de grosses améliorations. Quelque chose de très simple, comme un etherpad (NdT : ou Framapad), peut également faire l’affaire (ici, un cadre et un service exemple que vous pouvez utiliser).

Préparer les tâches

Pour vous rendre compte du nombre de tâches à préparer, nous vous recommandons de vous baser sur la durée de l’événement et le nombre de participants attendus pour prédire la charge en temps/homme de votre projet. Vous pouvez utiliser les estimations de temps que vous avez faites pour évaluer chaque tâche. Nous suggérons que vous prévoyiez 30% de plus que ce dont vous pensez que vous aurez besoin : il vaut mieux avoir trop que pas assez.

Exemple :

• Objectif de base : parcourir l’interface et étiqueter les tickets selon le type de résolution nécessaire. Est-ce qu’un bug doit être vérifié ? Est-ce qu’un patch doit être testé ? Une fonctionnalité doit-elle être rattachée à un jalon ?
  • Tâche 1 : étiqueter les problèmes
    • Compétences et outils nécessaires : compétences de base en anglais, connaissance des concepts de vérification, tests, jalons…
    • Temps estimé : ~20 minutes par problème
    • Pour démarrer : prenez connaissance du suiveur de tickets, et comment il affiche les informations. (Voyez cette documentation.) Demandez un accès Administrateur pour pouvoir ajouter des étiquettes au suiveur.
    • Pour chaque problème : lisez la discussion relative à chaque problème, et identifiez où la communauté intervient dans le signalement de ce problème. Si c’est un bug non vérifié, ajoutez le label non vérifié. Si c’est un patch non testé, ajoutez l’étiquette patch non testé, etc. Si c’est une fonctionnalité qui n’est rattaché à aucun jalon, ajoutez l’étiquette jalon nécessaire.
• Objectif étendu : utilisez les étiquettes comme un guide pour résoudre chaque ticket. Vérifiez les bugs, testez les patch, etc.
  • Tâche 1 : Vérifier les bugs
    • Compétences et outils nécessaires : compétences de base en anglais, et dans l’idéal connaître les machines virtuelles pour effectuer des tests sur plusieurs OS.
    • Temps estimé : 20 minutes par bug (variance élevée).
    • Pour démarrer : téléchargez l’environnement de développement et assurez vous que vous pouvez lancer le projet. Assurez vous que vous avez un compte sur Le suiveur de tickets et que vous savez ajouter des commentaires ou changer les étiquettes.
    • Pour chaque bug : essayez de reproduire le bug. Enregistrez les résultats dans un commentaire, avec des informations concernant le type de l’OS et sa version. Si possible, effectuez le test sur plusieurs navigateurs. S’il y a plusieurs commentaires récents sur les trois OS majoritaires, ajoutez l’étiquette prêt pour test par le mainteneur (NdT : ready_for_maintainer_review).

Quoi qu’il en soit, les participants doivent être rattachés à une tâche correspondant à leurs compétences et à leurs intérêts. Effectuer ce travail préparatoire fera démarrer les participants immédiatement plutôt que de les faire attendre que vous leur suggériez une tâche adéquate. Dans l’idéal, les organisateurs d’événements auront collecté des informations sur les compétences et intérêts des participants bien en amont, donc vous pourrez adapter la liste à votre groupe de contributeurs.

Rendre explicites les étapes de chaque tâche facilite l’entraide entre les participants. En identifiant clairement les compétences et concepts nécessaires, il devient plus facile pour les gens de dire : « Oh, je comprends comment faire ça ! Attends, je vais te montrer ».

Suite

Il est possible que les contributeurs ne puissent pas finir les tâches sur lesquelles ils travaillent pendant l’événement, ou qu’ils veuillent continuer à participer au projet en travaillant sur d’autres tâches. Penser en amont de l’événement à comment vous allez organiser sa suite rend plus facile l’échange d’informations avec les participants et la planification de la direction de votre projet.

Nous recommandons de demander à chaque participant de répondre aux questions suivantes à propos des tâches sur lesquelles ils ont travaillé. Donnez leur cette liste au début de l’événement : cela les aidera à documenter ce qu’ils font. Vous pouvez imprimer cette liste, l’envoyer par mail aux participants, faire un formulaire web, comme vous préférez.

Par exemple :

• Pour chaque tâche sur laquelle vous avez travaillé, veuillez répondre aux questions suivantes :
  • Sur quelle tâche avez-vous travaillé ?
  • Veuillez documenter brièvement votre workflow. Quelles étapes, dans quel ordre, pourquoi ?
  • Où puis-je trouver le travail que vous avez réalisé pendant l’événement ? Ceci inclut le code, la documentation, les maquettes, et autres choses.
  • Si vous avez créé des comptes pour le projet, veuillez lister les sites et les noms des comptes. Enregistrez le mot de passe dans votre gestionnaire de mot de passes préféré, ou assurez vous que moi ou un autre mainteneur y aie accès.
  • Quels obstacles avez-vous rencontré en travaillant sur cette tâche ? Avez-vous des retours à me faire pour améliorer le processus pour les futurs contributeurs ?
  • Voudriez-vous rester impliqué dans ce projet ? Si oui, dans quelle mesure ?

S’il y a suffisamment d’enthousiasme pour continuer le travail, assurez-vous de rester en contact ! Nous suggérons que vous rassembliez les emails des participants intéressés et que vous les contactiez dans les 48 heures suivant l’événement. Dans votre email, remerciez-les pour leur aide et fournissez des informations sur comment rester dans la communauté par, par exemple, IRC ou des listes de diffusion.

Nous recommendons aussi de prévoir un rendez-vous suite à l’événement. Si vous êtes tous originaires de la même région, essayez de fixer une date après l’événement pour vous et votre équipe au café du coin, à l’espace de coworking, ou à une soirée-projet. Si vous êtes éloignés géographiquement, fixez une date pour vous rencontrer sur IRC ou sur Google Hangout. 2-3 semaines après l’événement est un bon créneau, toutefois cela dépend si vous et vous nouveaux contributeurs êtes très occupés.

Checklists

Merci de votre attention ! Pour vous aider à garder un oeil sur chaque étape, nous avons créé deux checklists pour vous. La version détaillée inclut tous les conseils ci-dessus. La checklist la plus courte inclut les conseils que nous pensons les plus importants. Nous vous recommandons de démarrer avec la cheklist la plus courte. Une fois que vous avez accompli correctement cette checklist, vous pouvez revenir et faire les étapes supplémentaires si vous avez le temps et l’énergie.

Pour voir et/ou imprimer les checklists, se rendre ici.

Remerciements

Merci à tous ceux qui ont contribué ou aidé au projet.

Contributeurs

• Shauna Gordon-McKeon : maintenance, contenu
• Ni Mu : design
• Sheila Miguez : testeuse
• Asheesh Laroia : testeuse

Pour aller plus loin

• Open Advice (NdT : entièrement traduit par nos soins)
• Producing Open Source Software (NdT : entièrement traduit par nos soins)