Do you want to become an open source contributor, or help others reach that goal? This repository contains resources for you to participate in or run your own Ember.js Contributor's Workshop. There are slides, participant instructions, and survey templates. Please reach out to the authors for advice, assistance, etc. We're here to help.
Made with ❤️ by Jen Weber and Ricardo Mendes. Initially created for EmberConf 2018.
Need some quick inspiration? Check out Sean Massa's 2018 EmberConf talk about the many forms that OSS contributions take.
Follow these instructions so that you are prepared for the Contributors Workshop.
Learn how to get started in Open Source with a quick tutorial in this video:
- Ember.js Chat on Discord to get help from #dev-ember-learning
- The Ember.js Times to see recent calls to action
- Help Wanted dashboard - An easy way to browse issues that need a volunteer
Hi! Thanks for participating in an Open Source Contributor’s Workshop!
First of all, contributions come in many forms - writing articles, asking questions, opening PRs or Issues, helping other people out - so thank you for whatever you do!
We only have limited time, so help make the most of your it, there are some things you need to do ahead of time. New contributors should budget an hour to get their developer environment set up, and experienced contributors should take some time to look through issues and pick a couple that they might want to work on.
You're welcome to work on projects for any programming languages, frameworks, and libraries! If you are working on an Ember project, you can get help or ask questions on the #dev-ember-learning channel on the Ember.js Chat on Discord.
One of the things that team does is help contributors get started
on any part of the Ember ecosystem.
- Have git, node and npm installed, and have a GitHub account connected in git. If you need help with these steps, contact the Learning Team or your workshop facilitators.
- Install the latest stable ember-cli
npm install -g ember-cli@latest - Fork, clone, npm install, and test run projects you are interested in. When this workshop is run in person, it is essential to do ahead of time. While we hope and pray for the quality internet, most wifi can’t handle 50 devs cloning and npm installing all at the same time.
- Browse open issues to form some goals for yourself. See list of repositories and some helpful links below. You can work on anything during the workshop. The list just contains suggestions. Look for issues like "help wanted" or "good first issue" to guide your search.
- If you are not familiar with Open Source workflows (forking, cloning, opening PRs), try it out in this practice repository, while following this article of step-by-step instructions.
You are invited to work on issues in any open source projects! However, here are some "official" Ember repositories to get you started:
- ember.js - our favorite framework. Includes both technical and documentation issues
- data - home of ember-data
- ember.js website - public website at https://www.emberjs.com.
- The Ember.js Guides - the written content for https://guides.emberjs.com/
- ember-api-docs - the app that displays the documentation found in ember.js core code
- deprecation-app - an app that gives Ember's users information about how to overcome deprecations.
- ember-cli - home of the best command line tool for a front end framework
- ember-cli guides - help other people use the best cli
- statusboard - shows the status of ongoing Ember ecosystem projects at https://emberjs.com/statusboard/
- ember-styleguide - the component library used in Ember's family of websites. It handles typography, reusable components like callouts, how the navbar looks, and overall styles.
- ember-inspector - the browser extension dev tools for Ember
- ember-a11y org addons - a collection of accessibility specific addons and more for Ember.
Maintainers of these addons have specially asked for help and offered mentorship in the past:
@Gaiety#0001(Ava) with ember-select-light has some good first issues and she's mentored in the past- Have a suggestion? Submit a PR here to add to this list!
We’ve asked the maintainers of many ember projects to use the “good first issue” label to show which issues they’d like help on during the workshop. Again, you are welcome to choose any issue/project, but if you need ideas, click here to browse all of them! You might also want to search for “help wanted” issues.
Check out the Help Wanted dashboard to browse for issues!
If you want to choose one ahead of the workshop, you can add a comment that says you’d like to work on it.
Here are a few issues that we think you might want to check out!
- Improve docs to the Router Service in Ember.js
- ember-string needs some Node work
- ember-a11y needs help upgrading their addon versions! Open an issue on a repo if you are helping out. Look for issues opened by other people before you get started, so that you don't duplicate efforts.
ember-cli
If you need a little help getting something to the finish line, or it's been a week and your PR hasn't been reviewed yet, just drop by the #dev-ember-resources channel on Discord and let them know. The team is all volunteers, so getting help can take a little time, but it's part of the mission! Thanks for your patience!
