Skip to content

Latest commit

 

History

History
59 lines (45 loc) · 2.73 KB

CONTRIBUTING.md

File metadata and controls

59 lines (45 loc) · 2.73 KB

Contributing to Common Voice

🎉 First off, thanks for taking the time to contribute! This project would not be possible without people like you. 🎉

Code of Conduct

By participating in this project, you're agreeing to uphold the Mozilla Community Participation Guidelines. If you need to report a problem, please contact [email protected].

How Can I Contribute?

Add More Sentences

Help us add more sentences for other volunteers to read. See issue 341 for details.

Bug Fixes and Feature Enhancements

All of our current issues can be found here on GitHub. Anything with a help wanted tag is up for grabs.

Requirements

Local Development

If you haven't already, install the latest version of NodeJS and npm: https://nodejs.org/en/download/

Then enter the following commands:

npm install
npm install -g gulp
gulp

This will:

  1. Install all JavaScript dependencies.
  2. Build and serve files located in the web folder on localhost.
  3. Save uploaded voice clips onto Amazon's S3.
  4. Lint and rebuild all js files on every change.

You can then access the website at http://localhost:9000.

Need Help?

For more options, just type:

gulp help

Project Directory Structure

The project is organized into the following directories:

  • android: The Android app, a simple webview wrapper of voice.mozilla.org. This app is currently not published.
  • docs: Design and data specifications for Common Voice.
  • ios: The iOS app. This is a simple wrapper app for the website, as a workaround for a microphone issue in Safari.
  • nubis: Configuration files for Nubis, our deployment tool.
  • server: The server-side app logic, written in TypeScript.
  • tools: Some scripts for managing data.
  • web: The Common Voice website files, written in TypeScript. We use Preact to build the website.

Submitting an Issue

Did you notice a bug? Do you have a feature request? Please file an issue here on GitHub.

Something Else?

Want to talk about something but can't find a home for it here? Head to our Discourse Category to discuss everything from feedback and ideas to questions and random musings.