search

iamtrask / DEPRECATED

DEPRECATED - do not use!!!
Apache License 2.0
349 stars 48 forks source link

Docs/contributors adding projects #35

Closed cereallarceny closed 7 years ago

cereallarceny commented 7 years ago

Attempting to figure out how we may better guide users from "I want to help on this project" to actually joining a specific team or part of the OpenMined ecosystem. How do we direct people where they need to go to start helping?... rather than assume they'll figure it out on their own by reading Slack.

See Issue 36.

cereallarceny commented 7 years ago

I've gone ahead and filled out "Machine Learning" as a potential example... we'll want to document the others.

kevinahuber commented 7 years ago

I would leave this out of the quickstart, and make it a link outside of it. I think its SUPER overwhelming to have the project as a whole, and the quickstart is like the tutorial level to OpenMined. You kill some skeletons, make a fire, do your first spell, then receive a map from uncle Patrick upon completion.

cereallarceny commented 7 years ago

Fair enough, that's not a bad idea. Maybe treat it as a "token of accomplishment"? The only problem I see with that is it requires people to have a knowledge of Python and machine learning. Most front-end developers, much less designers, UX specialists, lawyers, and marketers will be able to get past that though. I would be concerned that could be a massive bottleneck for less technical individuals.

cereallarceny commented 7 years ago

@iamtrask I added the other sections in, but I'm not sure if I got all the right repos in the right place. Can I get a quick copy check to make sure all the information is factual? Also note, we don't have a sonar.js library so that's missing a link until further notice.

cereallarceny commented 7 years ago

@swaroopch I implemented the changes to the Slack channel names as discussed. Would you mind confirming this in my latest commit?

swaroopch commented 7 years ago

@cereallarceny Do we want to mention #beginner and #questions channels?

cereallarceny commented 7 years ago

Good idea, definitely. Working on a commit for all these changes.

cereallarceny commented 7 years ago

Approve the review and merge me in boss!

swaroopch commented 7 years ago

Approve the review and merge me in boss!

I can do that!? 😮

Just one blocking change - about #general-discussion (not #general) and we should be good to merge 🙂

cereallarceny commented 7 years ago

Pushed up those changes, sir! I think you can review it if you want. We can't merge until a review has been approved. :)

swaroopch commented 7 years ago

@cereallarceny github says "At least one approved review is required by reviewers with write access." - I guess I don't have write access :)

cereallarceny commented 7 years ago

Dang it! @iamtrask We need your help!

cereallarceny commented 7 years ago

Why do we want to put these at the end @iamtrask? What about for people who aren't technical or aren't Python developers? I can't imagine them being very interested in spinning up Sonar if they only have UI design expertise. I think that narrows the scope of interested individuals significantly - maybe we should appeal to less technically savvy individuals as well?

cereallarceny commented 7 years ago

I think that's a great idea @kevinahuber - seems like a good balance. I'll implement this now.