diff --git a/Gemfile.lock b/Gemfile.lock index 7c03a18f247..fff637b46fe 100644 --- a/Gemfile.lock +++ b/Gemfile.lock @@ -221,7 +221,7 @@ GEM parallel (1.17.0) pathutil (0.16.2) forwardable-extended (~> 2.6) - public_suffix (3.1.0) + public_suffix (3.1.1) rainbow (3.0.0) rake (12.3.2) rb-fsevent (0.10.3) diff --git a/_articles/finding-users.md b/_articles/finding-users.md index 84ec4c6e7ca..120380c975c 100644 --- a/_articles/finding-users.md +++ b/_articles/finding-users.md @@ -60,7 +60,7 @@ If you don't wish to set up outlets for your project yet, promote your own Twitt **Consider creating a website for your project.** A website makes your project friendlier and easier to navigate, especially when it's paired with clear documentation and tutorials. Having a website also suggests that your project is active which will make your audience feel more comfortable using it. Provide examples to give people ideas for how to use your project. -[@adrianholovaty](https://news.ycombinator.com/item?id=7531689), co-creator of Django, said that a website was _"by far the best thing we did with Django in the early days"_. +[@adrianholovaty](https://news.ycombinator.com/item?id=7531689), co-creator of Django, said that a website was _" by far the best thing we did with Django in the early days"_. If your project is hosted on GitHub, you can use [GitHub Pages](https://pages.github.com/) to easily make a website. [Yeoman](http://yeoman.io/), [Vagrant](https://www.vagrantup.com/), and [Middleman](https://middlemanapp.com/) are [a few examples](https://github.com/showcases/github-pages-examples) of excellent, comprehensive websites. @@ -110,7 +110,7 @@ If you're [new to public speaking](https://speaking.io/), start by finding a loc If you've never spoken at an event before, it's perfectly normal to feel nervous! Remember that your audience is there because they genuinely want to hear about your work. -As you write your talk, focus on what your audience will find interesting and get value out of. Keep your language friendly and approachable. Smile, breathe, and have fun. +As you write your talk, focus on what your audience will find interesting and get value out of. Keep your language friendly and approachable. Smile, breathe and have fun.
-[Il y a plein de raisons] (https://ben.balter.com/2015/11/23/why-open-source/) pour une personne ou une organisation de vouloir ouvrir un projet. Quelques exemples incluent: +[Il y a plein de raisons] (https://ben.balter.com/2015/11/23/why-open-source/) pour une personne ou une organisation de vouloir ouvrir un projet. Par exemple : * **Collaboration :** Les projets open source peuvent accepter des changements de n'importe qui dans le monde. [Exercism](https://github.com/exercism/), par exemple, est une plate-forme d'exercices de programmation avec plus de 350 contributeurs. -* **Adoption et remixage :** Les projets open source peuvent être utilisés par n'importe qui pour presque n'importe quel but. Les gens peuvent même l'utiliser pour construire d'autres choses. [WordPress](https://github.com/WordPress), par exemple, a commencé comme le fork d'un projet existant appelé [b2](https://github.com/WordPress/book/blob/master/Content/Part%201/2-b2-cafelog.md). +* **Adoption et remixage :** Les projets open source peuvent être utilisés par n'importe qui pour presque n'importe quel but. Les gens peuvent même l'utiliser pour construire d'autres choses. [WordPress](https://github.com/WordPress), par exemple, a commencé en tant que fork d'un projet existant appelé [b2](https://github.com/WordPress/book/blob/master/Content/Part%201/2-b2-cafelog.md). -* **Transparence :** Tout le monde peut inspecter un projet open source pour des erreurs ou des incohérences. La transparence est importante pour des gouvernements comme [Bulgarie](https://medium.com/@bozhobg/bulgaria-got-a-law-requiring-open-source-98bf626cf70a) ou les [États-Unis](https://sourcecode.cio.gov/), les industries réglementées comme la banque ou les soins de santé, et les logiciels de sécurité comme [Let's Encrypt](https://github.com/letsencrypt). +* **Transparence :** Tout le monde peut inspecter un projet open source pour y chercher des erreurs ou des incohérences. La transparence est importante pour des gouvernements comme celui de [Bulgarie](https://medium.com/@bozhobg/bulgaria-got-a-law-requiring-open-source-98bf626cf70a) ou des [États-Unis](https://sourcecode.cio.gov/), les industries réglementées comme la banque ou les soins de santé, et les logiciels de sécurité comme [Let's Encrypt](https://github.com/letsencrypt). -L'open source n'est pas seulement pour les logiciels. Vous pouvez ouvrir la source de tous les ensembles de données aux livres. Jetez un coup d'œil sur [GitHub Explore](https://github.com/explore) pour trouver des idées sur ce que vous pouvez faire d'autre. +L'open source n'est pas seulement pour les logiciels. Vous pouvez tout rendre open source depuis les jeux de données aux livres. Jetez un coup d'œil sur [GitHub Explore](https://github.com/explore) pour trouver des idées sur ce que vous pouvez faire d'autre. ### L'open source signifie-t-il "gratuit" ? -L'un des plus gros attrait de l'open source est qu'il ne coûte pas d'argent. La "gratuité"" est toutefois une conséquence de la valeur globale de l'open source. +L'un des plus gros attraits de l'open source est qu'il ne coûte pas d'argent. La "gratuité" est toutefois une conséquence de la valeur globale de l'open source. -Parce que [une licence open source nécessite](https://opensource.org/osd-annotated) que n'importe qui peut utiliser, modifier et partager votre projet pour presque n'importe quel but, les projets eux-mêmes ont tendance à être gratuits. Si le projet coûte de l'argent, n'importe qui peut légalement en faire une copie et utiliser la version gratuite à la place. +Puisqu'[une licence open source nécessite](https://opensource.org/osd-annotated) que n'importe qui puisse utiliser, modifier et partager votre projet dans pratiquement n'importe quel but, les projets eux-mêmes ont tendance à être gratuits. Si le projet coûte de l'argent, n'importe qui peut légalement en faire une copie et utiliser la version gratuite à la place. -En conséquence, la plupart des projets open source sont gratuits, mais "gratuitement" ne fait pas partie de la définition de l'open source. Il existe des moyens de facturer les projets open source indirectement à travers une double licence ou des fonctionnalités limitées, tout en respectant la définition officielle de l'open source. +En conséquence, la plupart des projets open source sont gratuits, mais la "gratuité" ne fait pas partie de la définition de l'open source. Il existe des moyens de facturer les projets open source indirectement à travers une double licence ou des fonctionnalités limitées, tout en respectant la définition officielle de l'open source. ## Dois-je lancer mon propre projet open source La réponse courte est oui, car peu importe le résultat, le lancement de votre propre projet est une excellente façon d'apprendre comment fonctionne l'open source. -Si vous n'avez jamais ouvert un projet auparavant, vous pourriez être nerveux à propos de ce que les gens diront, ou si personne ne le remarquera. Si cela vous ressemble, vous n'êtes pas seul! +Si vous n'avez jamais ouvert un projet auparavant, vous pourriez être nerveux à propos de ce que les gens diront, ou du risque que personne ne le remarque. Si cela vous ressemble, vous n'êtes pas seul ! -Le travail open source est comme toute autre activité créative, que ce soit l'écriture ou la peinture. Cela peut être effrayant de partager votre travail avec le monde, mais la seule façon de s'améliorer est de pratiquer - même si vous n'avez pas de public. +Le travail open source est comme toute autre activité créative, que ce soit l'écriture ou la peinture. Cela peut être effrayant de partager votre travail avec le reste du monde, mais la seule façon de s'améliorer est de pratiquer - même si vous n'avez pas de public. Si vous n'êtes pas encore convaincu, prenez un moment pour réfléchir à vos objectifs. ### Fixer vos objectifs -Les objectifs peuvent vous aider à déterminer ce sur quoi vous devez travailler, ce que vous devez dire non et où vous avez besoin de l'aide des autres. Commencez par vous demander: _pourquoi est-ce que j'ouvre ce projet ?_ +Les objectifs peuvent vous aider à déterminer ce sur quoi vous devez travailler, ce à quoi vous devez dire non et où vous avez besoin de l'aide des autres. Commencez par vous demander : _pourquoi est-ce que j'ouvre ce projet ?_ Il n'y a pas de bonne réponse à cette question. Vous pouvez avoir plusieurs objectifs pour un même projet ou différents projets avec des objectifs différents. @@ -83,13 +83,13 @@ Si votre seul objectif est de montrer votre travail, vous ne voulez peut-être m -Au fur et à mesure que votre projet grandit, votre communauté peut avoir besoin de plus que du code. Répondre aux problèmes, réviser le code et évangéliser votre projet sont des tâches importantes dans un projet open source. +Au fur et à mesure que votre projet grandit, votre communauté peut avoir besoin de plus que du code. Répondre aux problèmes, réviser le code et promouvoir votre projet sont des tâches importantes dans un projet open source. -Bien que le temps que vous consacrez à des tâches non codées dépende de la taille et de la portée de votre projet, vous devez vous préparer en tant que responsable pour les résoudre vous-même ou trouver quelqu'un pour vous aider. +Bien que le temps que vous consacrez à des tâches sans code dépende de la taille et de la portée de votre projet, vous devez vous préparer en tant que responsable à les résoudre par vous-même ou à trouver quelqu'un pour vous aider. -**Si vous faites partie d'un projet d'ouverture d'entreprise,** assurez-vous que votre projet dispose des ressources internes dont il a besoin pour prospérer. Vous voudrez identifier qui est responsable de la maintenance du projet après son lancement et comment vous allez partager ces tâches avec votre communauté. +**Si vous faites partie d'une entreprise qui ouvre le code source d'un projet,** assurez-vous que votre projet dispose des ressources internes dont il a besoin pour prospérer. Vous voudrez identifier qui est responsable de la maintenance du projet après son lancement et comment vous allez partager ces tâches avec votre communauté. -Si vous avez besoin d'un budget ou d'un personnel dédié pour la promotion, les opérations et la maintenance du projet, commencez ces conversations plus tôt. +Si vous avez besoin d'un budget ou d'un personnel dédié pour la promotion, les opérations et la maintenance du projet, commencez ces conversations aussi tôt que possible.— @tracymakes, ["Writing So Your Words Are Read (video)"](https://www.youtube.com/watch?v=8LiV759Bje0&list=PLmV2D6sIiX3U03qc-FPXgLFGFkccCEtfv&index=10)
@@ -159,15 +159,15 @@ Vous pouvez utiliser votre fichier README pour répondre à d'autres questions, Parfois, les gens évitent d'écrire un fichier README parce qu'ils ont l'impression que le projet n'est pas terminé ou qu'ils ne veulent pas de contributions. Ce sont toutes de très bonnes raisons d'en écrire une. -Pour plus d'inspiration, essayez d'utiliser celui de @18F ["Making READMEs Readable"](https://pages.18f.gov/open-source-guide/making-readmes-readable/) ou celui de @PurpleBooth [README template](https://gist.github.com/PurpleBooth/109311bb0361f32d87a2) pour écrire un fichier README complet. +Pour plus d'inspiration, essayez d'utiliser celui de @18F ["Making READMEs Readable"](https://pages.18f.gov/open-source-guide/making-readmes-readable/) ou le [modèle de README](https://gist.github.com/PurpleBooth/109311bb0361f32d87a2) de @PurpleBooth pour écrire un fichier README complet. -Lorsque vous incluez un fichier README dans le répertoire racine, GitHub l'affiche automatiquement sur la page d'accueil du référentiel. +Lorsque vous incluez un fichier README dans le répertoire racine, GitHub l'affiche automatiquement sur la page d'accueil du dépot. ### Rédaction de vos directives de contribution Un fichier CONTRIBUTING indique à votre audience comment participer à votre projet. Par exemple, vous pouvez inclure des informations sur: -* Comment déposer un rapport de bug (essayez d'utiliser [question et tirer des modèles de demande](https://github.com/blog/2111-issue-and-pull-request-templates)) +* Comment déposer un rapport de bug (essayez d'utiliser [des modèles de questions et de pull requests](https://github.com/blog/2111-issue-and-pull-request-templates)) * Comment proposer une nouvelle fonctionnalité * Comment configurer votre environnement et exécuter des tests @@ -187,9 +187,9 @@ Dans les premières étapes de votre projet, votre fichier CONTRIBUTING peut êt Au fil du temps, vous pouvez ajouter d'autres questions fréquemment posées à votre fichier CONTRIBUTING. L'écriture de cette information signifie que moins de personnes vous poseront les mêmes questions encore et encore. -Pour plus d'aide avec la rédaction de votre fichier CONTRIBUTING, consultez le [template du guide de contribution de @nayafia](https://github.com/nayafia/contributing-template/blob/master/CONTRIBUTING-template.md) ou @mozilla ["Comment Construire un CONTRIBUTING.md"](https://mozillascience.github.io/working-open-workshop/contributing/). +Pour plus d'aide avec la rédaction de votre fichier CONTRIBUTING, consultez le [modèle de guide de contribution de @nayafia](https://github.com/nayafia/contributing-template/blob/master/CONTRIBUTING-template.md) ou le guide de @mozilla ["Comment Construire un CONTRIBUTING.md"](https://mozillascience.github.io/working-open-workshop/contributing/). -Lien vers votre fichier CONTRIBUTING à partir de votre fichier README, afin que plus de gens le voient. Si vous [placez le fichier CONTRIBUTING dans le repository de votre projet](https://help.github.com/articles/setting-guidelines-for-repository-contributors/), GitHub liera automatiquement votre fichier lorsqu'un contributeur crée un problème ou ouvre une requête de tirage. +Ajoutez un lien vers votre fichier CONTRIBUTING dans votre fichier README, afin que plus de gens le voient. Si vous [placez le fichier CONTRIBUTING dans le repository de votre projet](https://help.github.com/articles/setting-guidelines-for-repository-contributors/), GitHub affichera automatiquement un lien vers votre fichier lorsqu'un contributeur crée un problème ou ouvre une pull request. ![Lignes directrices contributives](/assets/images/starting-a-project/Contributing-guidelines.jpg) @@ -197,7 +197,7 @@ Lien vers votre fichier CONTRIBUTING à partir de votre fichier README, afin que— @mlynch, ["Making Open Source a Happier Place"](https://medium.com/ionic-and-the-mobile-web/making-open-source-a-happier-place-3b90d254f5f)
@@ -207,13 +207,13 @@ Enfin, un code de conduite permet de définir des règles de base pour le compor Pour plus d'informations, consultez notre [Code de conduite](../code-of-conduct/). -En plus de communiquer _comment_ vous souhaitez que les participants se comportent, un code de conduite a également tendance à décrire à qui s'appliquent ces attentes, quand ils s'appliquent, et que faire en cas de violation. +En plus de d'indiquer _comment_ vous souhaitez que les participants se comportent, un code de conduite a également tendance à décrire à qui s'appliquent ces attentes, quand elles s'appliquent, et que faire en cas de violation. Tout comme les licences open source, il existe également des normes émergentes pour les codes de conduite, vous n'avez donc pas besoin d'écrire les vôtres. Le [Contributor Covenant](https://contributor-covenant.org/)) est un code de conduite qui est utilisé par [plus de 40 000 projets open source](https://www.contributor-covenant.org/adopters) , y compris Kubernetes, Rails et Swift. Quel que soit le texte que vous utilisez, vous devez être prêt à appliquer votre code de conduite si nécessaire. Collez le texte directement dans un fichier CODE_OF_CONDUCT dans votre repository. Conservez le fichier dans le répertoire racine de votre projet pour qu'il soit facile à trouver et liez-le à partir de votre fichier README. -## Nommer et marquer votre projet +## Nommer et créer l'image de marque de votre projet La marque est plus qu'un logo flashy ou un nom de projet accrocheur. Il s'agit de la façon dont vous parlez de votre projet et de qui vous parlez avec votre message. @@ -221,30 +221,30 @@ La marque est plus qu'un logo flashy ou un nom de projet accrocheur. Il s'agit d Choisissez un nom facile à retenir et, idéalement, qui donne une idée de ce que fait le projet. Par exemple: -* [Sentry](https://github.com/getsentry/sentry) surveille les applications pour via les rapports d'erreur +* [Sentry](https://github.com/getsentry/sentry) surveille les applications pour fournir des rapports d'erreur * [Thin](https://github.com/macournoyer/thin) est un serveur web Ruby simple et rapide Si vous construisez sur un projet existant, l'utilisation de leur nom comme préfixe peut aider à clarifier ce que fait votre projet (par exemple, [node-fetch](https://github.com/bitinn/node-fetch) apporte `window.fetch` à Node.js). -Pensez à la clarté avant tout. Les jeux de mots sont amusants, mais rappelez-vous que certaines blagues peuvent ne pas se traduire dans d'autres cultures ou des personnes ayant des expériences différentes de vous peuvent ne pqs comprendre. Certains de vos utilisateurs potentiels peuvent être des employés de l'entreprise : vous ne voulez pas les mettre mal à l'aise quand ils doivent expliquer votre projet au travail ! +Pensez à la clarté avant tout. Faire des jeux de mots, c'est amusant, mais rappelez-vous que certaines blagues peuvent ne pas se traduire dans d'autres cultures et des personnes ayant des expériences différentes de vous peuvent ne pas les comprendre. Certains de vos utilisateurs potentiels peuvent être des employés dans une entreprise : vous ne voulez pas les mettre mal à l'aise quand ils devront expliquer votre projet au travail ! ### Eviter les conflits de noms -[Vérifiez les projets open source avec un nom similaire](http://ivantomic.com/projects/ospnc/), surtout si vous partagez le même langage ou écosystème. Si votre nom chevauche un projet existant populaire, vous risquez de perturber votre auditoire. +[Vérifiez les projets open source avec un nom similaire](http://ivantomic.com/projects/ospnc/), surtout si vous partagez le même langage ou écosystème. Si votre nom est trop proche de celui d'un projet existant populaire, vous risquez de perturber votre auditoire. -Si vous souhaitez un site Web, un pseudo Twitter ou d'autres propriétés pour représenter votre projet, assurez-vous de pouvoir obtenir les noms souhaités. Idéalement, [réservez ces noms maintenant](https://instantdomainsearch.com/) pour votre tranquillité d'esprit, même si vous n'avez pas l'intention de les utiliser pour l'instant. +Si vous souhaitez un site Web, un pseudo Twitter ou d'autres entités pour représenter votre projet, assurez-vous de pouvoir obtenir les noms souhaités. Idéalement, [réservez ces noms maintenant](https://instantdomainsearch.com/) pour votre tranquillité d'esprit, même si vous n'avez pas l'intention de les utiliser pour l'instant. -Assurez-vous que le nom de votre projet ne porte atteinte à aucune marque. Une entreprise peut vous demander de retirer votre projet plus tard, ou même intenter une action en justice contre vous. Cela ne vaut tout simplement pas le risque. +Assurez-vous que le nom de votre projet ne porte atteinte à aucune marque. Une entreprise pourrait vous demander d'arrêter votre projet dans le futur, ou même intenter une action en justice contre vous. Cela ne vaut tout simplement pas le risque. -Vous pouvez consulter la [Base de données mondiale de l'OMPI sur les marques](http://www.wipo.int/branddb/en/) pour les conflits de marques. Si vous êtes dans une entreprise, c'est une des choses pour lesquelles [votre équipe juridique peut vous aider](../legal/). +Vous pouvez consulter la [Base de données mondiale de l'OMPI sur les marques](http://www.wipo.int/branddb/en/) pour les conflits de marques. Si vous êtes dans une entreprise, c'est un des sujets sur lesquels [votre équipe juridique peut vous aider](../legal/). -Enfin, effectuez une recherche rapide sur Google pour le nom de votre projet. Les gens pourront-ils trouver facilement votre projet ? Est-ce que quelque chose d'autre apparaît dans les résultats de recherche que vous ne voudriez pas voir ? +Enfin, recherchez le nom de votre projet sur Google. Les gens pourront-ils trouver facilement votre projet ? Est-ce que quelque chose d'autre apparaît dans les résultats de recherche que vous ne voudriez pas qu'ils voient ? ### Comment vous écrivez (et codez) affecte votre marque, aussi ! Tout au long de la vie de votre projet, vous allez beaucoup écrire : des fichiers README, des didacticiels, des documents communautaires, des réponses aux problèmes, peut-être même des bulletins d'informations et des listes de diffusion. -Qu'il s'agisse d'une documentation officielle ou d'un courriel occasionnel, votre style d'écriture fait partie de la marque de votre projet. Considérez comment vous pourriez rencontrer votre public et si c'est le ton que vous souhaitez transmettre. +Qu'il s'agisse d'une documentation officielle ou d'un courriel occasionnel, votre style d'écriture fait partie de la marque de votre projet. Réfléchissez à comment vous pourriez rencontrer votre public et au ton que vous souhaitez utiliser pour communiquer avec eux.