This repository contains resources for you to run your own Ember.js Contributor's Workshop, such as 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.
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:
Hi! Thanks for participating in the Ember.js Contributor’s Workshop!
We only have 3 hours for the event, so help make the most of your time, there are some things you need to do ahead of time. Most attendees should budget at least 2 hours for this and try to do it at least 5-10 days before the event. The facilitators will be best able to help walk you through any issues you encounter if they aren’t last-minute requests. Send any questions or requests for help to @bryanhickerson and @paulcwatts on the Ember.js Seattle Community Slack
- Install the latest stable ember-cli
npm uninstall -g ember-cli && npm install -g ember-cli - Fork, clone, npm install, and test run projects you are interested in. This is essential to do ahead of time. While we hope and pray for the quality internetz, 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.
- Have node, git, and npm installed, and have a GitHub account connected in git. If you need help with these steps, contact the facilitators.
- If you want to work on the https://emberjs.com website or The Guides, budget some extra time to install Docker or Ruby.
- 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 project related to Ember, both official and community projects. However, here are some 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 www.emberjs.com *
- The Guides - public website at 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.
- builds - the builds and releases section of the website
- ember-cli - home of the best command line tool for a front end framework
- ember-cli website and docs - help other people use the best cli *
- statusboard - shows the status of ongoing Ember ecosystem projects at https://emberjs.com/statusboard/
- guides-app - the WIP app that will eventually replace the current Ruby-based guides application
- ember-styleguide - a WIP component library to be used in Ember's family of webssites
- ember-inspector - the browser extension dev tools for Ember
- optional, but recommended to install Docker to run these locally
Maintainers of these addons have specially volunteered to curate some issues and guide new contributors.
- ember-changeset - checks new objects for validity (nucleartide)
- ember-changeset-validations - a library to validate user form entries (nucleartide)
- qunit-dom - DOM assertions for testing (Tobias Bieniek)
- ember-cli-code-coverage - see how good your test suite is (Robert Wagner)
- html-next - a collection of addons focused on performance and rendering (Robert Wagner)
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.
If you want to choose one ahead of the workshop, you can add a comment that says you’d like to work on it.