Skip to content

Latest commit

 

History

History
142 lines (97 loc) · 6.03 KB

README.md

File metadata and controls

142 lines (97 loc) · 6.03 KB

This project uses GitHub Actions for continuous integration. This project uses Percy.io for visual regression testing.

ember-help-wanted

This app helps you find Ember-related issues and contribute to open source. It works well for project nights for meetups, conferences, and hackathons.

The app is designed to interface with ember-help-wanted-server as the backend.

Big picture

Our goal with this app is to do two major things in the Ember community.

One: create an efficient way of exposing major projects in the Ember ecosystem to a wide audience of volunteers (of varying levels of expertise) to get major blockers addressed by crowd-sourcing the effort. Currently, project maintainers will write up epic issues (see the Glimmer2 help issue or the Ember website responsive issue for examples of issues that have had real success) but after the initial tweet and announcement, these issues tend to disappear off people's radar.

Two: provide a curated pool of issues (from a variety of major Ember projects) that folks either new to Ember (or new to contributing to Ember) can use as a diving-in point to getting to know people in the Ember ecosystem. Oftentimes people will be interested in contributing, but are a bit daunted by browsing the various repos in Ember to try to find issues that they can actually help with. Although a "good for new contributors" or "help wanted" label is often applied, there may not be enough information in those issues to allow newcomers to really dive in.

The goal would be to use this tool to encourage maintainers to write up issues in deeper detail so that those issues would be added to the Help Wanted board and made generally available. This might also increase the number of regular contributors to various projects, which in turn could help the entire community accomplish ambitious things faster.

Big picture, technically

To accomplish the above, we aim to have a Node backend that receives Github webhook notifications about issues across a number of Ember projects. The backend will filter those issues and store them to act as our "pool" of potential issues that potential contributors can work on.

Those issues will then surface in this Ember app, where they can be searched and filtered in various ways as each potential contributor desires. We may add some level of curation to the issues (whether that is needed is still to be determined) or in other ways editorialize as issues show up in the app.

Future goals

We hope that meetup organizers (and contributor workshops at various Ember conferences) are able to sort through issues and pick subsets for their meetings. For example, if a meetup group wants to help its members learn more about Ember Data, a meetup organizer could go through the existing pool of issues and cherry-pick 5-10 issues for folks to focus on for that evening that would help with that.

Or this tool could be used as a foundation for running the Contributors Workshop that occurs each year at EmberConf. 😀

Long-term, we also wonder about tweeting out major new issues or in other ways exposing key pieces of info to the greater Ember world (we could potentially use it as a way of posting "maintainer wanted" messages as well).

If you're interested in helping out or have other ideas on how to improve this, please write up an issue or contact us on the Ember Community Discord #st-help-wanted-board channel. Look forward to working on these things with you further!

Prerequisites

You will need the following things properly installed on your computer.

Installation

  • git clone <repository-url> this repository
  • cd ember-help-wanted
  • npm install

Running / Development

By default we have an api-proxy that uses the production API when developing locally, so you don't need to run the ember-help-wanted-server when editing the Ember frontend.

If you are developing the backend and want your local Ember frontend to hit your local server, then you can start the server like this:

LOCAL_API=true ember s

Code Generators

Make use of the many generators for code, try ember help generate for more details

Running Tests

  • npm test
  • npm test --server

Linting

  • npm run lint
  • npm run lint:fix

Building

  • npm build (production)

Deploying

Specify what it takes to deploy your app.

Further Reading / Useful Links