Skip to content

Latest commit

 

History

History
90 lines (70 loc) · 4.16 KB

CONTRIBUTING.md

File metadata and controls

90 lines (70 loc) · 4.16 KB

Contributing ❤️

Thanks for thinking about helping with dart.dev! You can contribute in a few ways.

  • Fix typos. The GitHub UI makes it easy to contribute small fixes, and you'll get credit for your contribution! To start, click the page icon at the upper right of the page. Then click the pencil icon to start editing the file. Once you've fixed the typo, commit your changes to a new branch and create a pull request.

    Once we've reviewed and approved your change, we'll merge it. Normally, we'll review your fix within one working day, and your fix will appear online less than an hour after we merge your PR.

    Note: If this is your first contribution to a Google project—welcome!—you'll need to sign the CLA.

  • Report issues.

  • Fix known issues (especially ones with the label help wanted or beginner). These issues may or may not be easy to fix. Sometimes they're issues that we don't have the expertise to fix, and we'd love to work with a contributor who has the right skills.

More info:

Updating code samples

If your PR changes Dart code within a page, you'll probably need to change the code in two places:

  1. In a .md file for the page.
  2. In a .dart file under the /examples directory.

For example, say you want to change the following code in the Variables documentation:

<?code-excerpt "misc/lib/language_tour/variables.dart (var-decl)"?>
{% prettify dart tag=pre+code %}
var name = 'Bob';
{% endprettify %}

Besides editing /src/language/variables.md (which you can find by clicking the GitHub icon at the top right of the page), you'll also need to edit the var-decl region of /examples/misc/lib/language_tour/variables.dart.

If you create a PR but forget to edit the Dart file, or if your changes don't analyze/test cleanly, the GitHub Actions CI build will fail. Just update the PR, and GitHub Actions will run again.

A word about conduct

We pledge to maintain an open and welcoming environment. For details, see our code of conduct.