-
Notifications
You must be signed in to change notification settings - Fork 14.6k
Commit
This commit does not belong to any branch on this repository, and may belong to a fork outside of the repository.
finished up code-of-conduct.md and created finding-users.md and wrote…
… in it
- Loading branch information
1 parent
5adac19
commit 05644cf
Showing
2 changed files
with
202 additions
and
2 deletions.
There are no files selected for viewing
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Original file line number | Diff line number | Diff line change |
---|---|---|
@@ -0,0 +1,144 @@ | ||
--- | ||
lang: pidgin | ||
title: How to find the people to helep your project | ||
description: You go helep your open source project grow if you bin put am with people waeh dey happy happy. | ||
class: finding | ||
order: 3 | ||
image: /assets/images/cards/finding.png | ||
related: | ||
- beginners | ||
- building | ||
--- | ||
|
||
## Dey talk the koko | ||
|
||
Dem nor get law wey talk say you suppose promote open source project when you first launch am. Plenty reasons dey wey fit make person dey work for open source wey nor get to do with popularity. Instead make you hope say other people go find and use your open source project, you suppose spread the word about your hard work! | ||
|
||
## Make you dey find your message | ||
|
||
Before you start the real work of promotion for your project, you suppose sabi explain wetin your project dey do, and why e dey important. | ||
|
||
Wetin make your project different or interesting? Why you create am? As you dey think about your project's message and value, try look am through the eyes of the people wey fit use am and those wey fit contribute to am. | ||
|
||
For example, @robb dey use code examples to yan clearly why him project, [Cartography](https://github.com/robb/Cartography), dey useful: | ||
|
||
![Cartography README](/assets/images/finding-users/cartography.jpg) | ||
|
||
If you wan go deeper for messaging, check Mozilla's ["Personas and Pathways"](https://mozillascience.github.io/working-open-workshop/personas_pathways/) exercise for developing user personas. | ||
|
||
## Helep people to dey find and folow your project | ||
|
||
<aside markdown="1" class="pquote"> | ||
Ideally, you suppose get one "home" URL wey you go fit promote and direct people to for your project. You nor need spend plenty money for fine design or even buy domain name, but your project suppose get one main place where people fit find am. | ||
<p markdown="1" class="pquote-credit"> | ||
— Peter Cooper & Robert Nyman, ["How to Spread the Word About Your Code"](https://hacks.mozilla.org/2013/05/how-to-spread-the-word-about-your-code/) | ||
</p> | ||
</aside> | ||
|
||
**Make you get clear handle to promote your work.** Twitter handle, GitHub URL, or IRC channel na easy way wey you fit use point people to your project. These outlets still dey give your project's growing community place wey dem go fit gather. | ||
|
||
If you nor wan set up outlets for your project now, make you dey promote your own Twitter or GitHub handle for everything wey you dey do. Promoting your Twitter or GitHub handle go show people how dem fit take contact you or follow your work. If you go talk for meeting or event, make you sure say your contact information dey for your bio or slides. | ||
|
||
<aside markdown="1" class="pquote"> | ||
<img src="https://avatars.githubusercontent.com/nathanmarz?s=180" class="pquote-avatar" alt="avatar"> | ||
One mistake wey I make for those early days... no be say I start Twitter account for the project. Twitter na better way to dey give people updates about the project and dey always show people the project. | ||
<p markdown="1" class="pquote-credit"> | ||
— @nathanmarz, ["History of Apache Storm and Lessons Learned"](http://nathanmarz.com/blog/history-of-apache-storm-and-lessons-learned.html) | ||
</p> | ||
</aside> | ||
|
||
**Make you think about create website for your project.** Website dey make your project dey friendly and easy to navigate, especially when you combine am with clear documentation and tutorials. Having website still show say your project dey active and e go make your audience feel comfortable say dem fit use am. Give examples to show people as dem fit take use your project. | ||
|
||
[@adrianholovaty](https://news.ycombinator.com/item?id=7531689), co-creator of Django, talk say website na _"by far the best thing we did with Django in the early days"_. | ||
|
||
If your project dey for GitHub, you fit use [GitHub Pages](https://pages.github.com/) create website. [Yeoman](http://yeoman.io/), [Vagrant](https://www.vagrantup.com/), and [Middleman](https://middlemanapp.com/) na [few examples](https://github.com/showcases/github-pages-examples) of excellent, comprehensive websites. | ||
|
||
![Vagrant homepage](/assets/images/finding-users/vagrant_homepage.png) | ||
|
||
Now wey you don get message for your project and easy way wey people fit take find your project, make you waka comot go yan with your audience! | ||
|
||
## Go where your project's audience dey (online) | ||
|
||
Online outreach na correct way wey you fit take share and spread the word quickly. As you use online channels, e fit help you reach wide audience. | ||
|
||
Make you use existing online communities and platforms to reach your audience. If your open source project na software project, e possible say you fit find your audience for [Stack Overflow](https://stackoverflow.com/), [Reddit](https://www.reddit.com), [Hacker News](https://news.ycombinator.com/), or [Quora](https://www.quora.com/). Find the channels wey you believe say people go benefit well or go dey excited about your work. | ||
|
||
<aside markdown="1" class="pquote"> | ||
<img src="https://avatars.githubusercontent.com/pazdera?s=180" class="pquote-avatar" alt="avatar"> | ||
Each program get specific functions wey only small number of users go find useful. Nor go dey disturb plenty people as you fit. Instead, focus your efforts on communities wey go gain from knowing about your project. | ||
<p markdown="1" class="pquote-credit"> | ||
— @pazdera, ["Marketing for open source projects"](https://radek.io/2015/09/28/marketing-for-open-source-projects-3/) | ||
</p> | ||
</aside> | ||
|
||
See as you fit find ways to share your project well: | ||
|
||
* **Know the relevant open source projects and communities.** Sometimes, you nor need promote your project directly. If your project dey perfect for data scientists wey dey use Python, make you sabi the Python data science community. As people sabi you, opportunities go naturally show face to talk about and share your work. | ||
* **Find people wey dey face the problem wey your project solve.** Search through forums wey relate to your project's target audience, and try to answer their questions. If e dey right, find polite way to suggest your project as solution. | ||
* **Ask for feedback.** Introduce yourself and your work to audience wey your project fit benefit. Make you specific about the people wey you think say your project go fit help. Try to complete the sentence: _"I think my project go really help X, people wey dey try do Y_". Listen and respond to others' feedback, rather than just promoting your work. | ||
|
||
Generally, focus on helping others before you ask for something in return. Because anybody fit easily promote project online, e go get plenty noise. To stand out from the crowd, give people background about who you be, nor be just wetin you want. | ||
|
||
If nobody pay attention or respond to your initial outreach, nor let am discourage you! Most project launches nor dey one-time thing, e fit take months or years. If you nor get response the first time, try different method, or look for ways to add value to other people's work first. Promotion and launch of your project go take time and dedication. | ||
|
||
## Waka go where your project's audience dey (offline) | ||
|
||
![Public speaking](/assets/images/finding-users/public_speaking.jpg) | ||
|
||
Offline events dey very popular to promote new projects to people. Dem be very good way to reach audience wey dey engage and build better human connections, especially if you wan reach developers. | ||
|
||
If you be [newbie for public speaking](https://speaking.io/), you fit start by dey find local meetup wey relate to the language or system wey your project dey based on. | ||
|
||
<aside markdown="1" class="pquote"> | ||
<img src="https://avatars.githubusercontent.com/jhamrick?s=180" class="pquote-avatar" alt="avatar"> | ||
I bin dey very nervous about PyCon. I bin wan give talk, I only know few people wey dey there, I bin wan dey there for one whole week. (...) But I no suppose dey worry, PyCon bin sweet die! (...) Everybody bin friendly and I rarely get time wey I no dey talk with people! | ||
<p markdown="1" class="pquote-credit"> | ||
— @jhamrick, ["How I learned to Stop Worrying and Love PyCon"](http://www.jesshamrick.com/2014/04/18/how-i-learned-to-stop-worrying-and-love-pycon/) | ||
</p> | ||
</aside> | ||
|
||
If you never talk for event before, e dey normal to feel nervous! Just remember say the people wey dey the audience dey there because dem really wan hear wetin you wan talk about. | ||
|
||
As you dey write your talk, try focus on the things wey your audience go find interesting and get value from. Make your language dey friendly and approachable. Smile, breathe well, and enjoy yourself. | ||
|
||
<aside markdown="1" class="pquote"> | ||
<img src="/assets/images/finding-users/lena.jpg" class="pquote-avatar" alt="avatar"> | ||
When you start writing your talk, no matter what your topic is, it can help if you see your talk as a story that you tell people. | ||
<p markdown="1" class="pquote-credit"> | ||
— Lena Reinhard, ["How to Prepare and Write a Tech Conference Talk"](https://web.archive.org/web/20201128162836/http://wunder.schoenaberselten.com/2016/02/16/how-to-prepare-and-write-a-tech-conference-talk/) | ||
</p> | ||
</aside> | ||
|
||
When you feel say you don ready, try consider talk for conference to promote your project. Conferences fit help you reach plenty people, sometimes from different parts of the world. | ||
|
||
Find conferences wey relate to the language or system wey your project dey use. Before you submit your talk, try do research about the conference so that you fit arrange your talk to match the people wey go attend and increase your chance to talk for the conference. Sometimes you fit know the kind of audience wey you wan get by checking the people wey don talk for the conference before. | ||
|
||
<aside markdown="1" class="pquote"> | ||
<img src="https://avatars.githubusercontent.com/ry?s=180" class="pquote-avatar" alt= "avatar"> | ||
I write polite message to the JSConf people beg them make dem give me small chance make I fit talk for JSConf EU. (...) I bin very scared, I wan present the thing wey I don work on for six months. (...) All the time I bin dey think, oh my God. Wetin I dey do here? | ||
<p markdown="1" class="pquote-credit"> | ||
— @ry, ["History of Node.js" (video)](https://www.youtube.com/watch?v=SAc0vQCC6UQ&t=24m57s) | ||
</p> | ||
</aside> | ||
|
||
## Kulekule your reputation | ||
|
||
Apart from the strategies wey we don yarn before, the best way to invite people to share and contribute to your project na to share and contribute to their projects. | ||
|
||
To help newcomers, share resources, and make thoughtful contributions to other people's projects go help you build positive reputation. To be an active member for open source community go help people to understand wetin you dey do, and dem fit dey pay attention to and share your project. To dey develop relationships with other open source projects fit even lead to official partnerships. | ||
|
||
<aside markdown="1" class="pquote"> | ||
<img src="https://avatars.githubusercontent.com/shazow?s=180" class="pquote-avatar" alt="avatar"> | ||
The only reason urllib3 is the most popular third-party Python library today is because it's part of requests. | ||
<p markdown="1" class="pquote-credit"> | ||
— @shazow, ["How to make your open source project thrive"](https://about.sourcegraph.com/blog/how-to-make-your-open-source-project-thrive-with-andrey-petrov/) | ||
</p> | ||
</aside> | ||
|
||
E no dey too early or too late to begin build your reputation. Even if you don launch your own project before, dey always look for ways to help others. | ||
|
||
No get quick fix wey go give you audience. To gain the trust and respect of others dey take time, and building your reputation no dey end. | ||
|
||
## No relent! | ||
|
||
E fit tey before people go notice your open source project. E dey okay! Some of the most popular projects wey dey today, e take years before dem reach the level wey dem dey now. Focus on building relationships instead of dey hope say your project go just blow. Be patient, and continue to dey share your work with those wey dey appreciate am. |