You can not select more than 25 topics Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.

635 lines
20 KiB

8 years ago
<!DOCTYPE HTML>
<html lang="" >
<head>
<meta charset="UTF-8">
<meta content="text/html; charset=utf-8" http-equiv="Content-Type">
<title>Contributing · Neutrino</title>
<meta http-equiv="X-UA-Compatible" content="IE=edge" />
<meta name="description" content="">
<meta name="generator" content="GitBook 3.2.2">
<link rel="stylesheet" href="../gitbook/style.css">
<link rel="stylesheet" href="../gitbook/gitbook-plugin-prism/prism.css">
<link rel="stylesheet" href="../gitbook/gitbook-plugin-search/search.css">
<link rel="stylesheet" href="../gitbook/gitbook-plugin-fontsettings/website.css">
<meta name="HandheldFriendly" content="true"/>
<meta name="viewport" content="width=device-width, initial-scale=1, user-scalable=no">
<meta name="apple-mobile-web-app-capable" content="yes">
<meta name="apple-mobile-web-app-status-bar-style" content="black">
<link rel="apple-touch-icon-precomposed" sizes="152x152" href="../gitbook/images/apple-touch-icon-precomposed-152.png">
<link rel="shortcut icon" href="../gitbook/images/favicon.ico" type="image/x-icon">
8 years ago
<link rel="next" href="development.html" />
8 years ago
<link rel="prev" href="../cli/" />
</head>
<body>
<div class="book">
<div class="book-summary">
<div id="book-search-input" role="search">
<input type="text" placeholder="Type to search" />
</div>
<nav role="navigation">
<ul class="summary">
<li class="chapter " data-level="1.1" data-path="../">
<a href="../">
Introduction
</a>
</li>
<li class="chapter " data-level="1.2" data-path="../installation.html">
<a href="../installation.html">
Installation
</a>
</li>
<li class="chapter " data-level="1.3" data-path="../usage.html">
<a href="../usage.html">
Usage
</a>
</li>
<li class="chapter " data-level="1.4" data-path="../project-layout.html">
<a href="../project-layout.html">
Project Layout
</a>
</li>
<li class="chapter " data-level="1.5" data-path="../presets/">
<a href="../presets/">
Presets
</a>
<ul class="articles">
<li class="chapter " data-level="1.5.1" data-path="../presets/neutrino-preset-web/">
<a href="../presets/neutrino-preset-web/">
8 years ago
Web
8 years ago
</a>
</li>
<li class="chapter " data-level="1.5.2" data-path="../presets/neutrino-preset-react/">
<a href="../presets/neutrino-preset-react/">
8 years ago
React
8 years ago
</a>
</li>
<li class="chapter " data-level="1.5.3" data-path="../presets/neutrino-preset-node/">
<a href="../presets/neutrino-preset-node/">
8 years ago
Node.js
8 years ago
</a>
</li>
8 years ago
<li class="chapter " data-level="1.5.4" data-path="../presets/neutrino-preset-airbnb-base/">
8 years ago
8 years ago
<a href="../presets/neutrino-preset-airbnb-base/">
8 years ago
8 years ago
Airbnb
8 years ago
</a>
</li>
8 years ago
<li class="chapter " data-level="1.5.5" data-path="../presets/neutrino-preset-karma/">
8 years ago
8 years ago
<a href="../presets/neutrino-preset-karma/">
8 years ago
8 years ago
Karma
8 years ago
</a>
</li>
8 years ago
<li class="chapter " data-level="1.5.6" data-path="../presets/neutrino-preset-mocha/">
8 years ago
8 years ago
<a href="../presets/neutrino-preset-mocha/">
8 years ago
8 years ago
Mocha
8 years ago
</a>
</li>
8 years ago
<li class="chapter " data-level="1.5.7" data-path="../presets/neutrino-preset-jest/">
8 years ago
8 years ago
<a href="../presets/neutrino-preset-jest/">
8 years ago
8 years ago
Jest
8 years ago
</a>
</li>
</ul>
</li>
<li class="chapter " data-level="1.6" data-path="../customization/">
<a href="../customization/">
Customization
</a>
<ul class="articles">
<li class="chapter " data-level="1.6.1" data-path="../customization/simple.html">
<a href="../customization/simple.html">
Simple
</a>
</li>
<li class="chapter " data-level="1.6.2" data-path="../customization/advanced.html">
<a href="../customization/advanced.html">
Advanced
</a>
</li>
</ul>
</li>
8 years ago
<li class="chapter " data-level="1.7" data-path="../creating-presets.html">
8 years ago
8 years ago
<a href="../creating-presets.html">
8 years ago
Creating presets
</a>
8 years ago
<ul class="articles">
<li class="chapter " data-level="1.7.1" data-path="../presets/neutrino-lint-base/">
<a href="../presets/neutrino-lint-base/">
Creating linting presets
</a>
</li>
</ul>
8 years ago
</li>
8 years ago
<li class="chapter " data-level="1.8" data-path="../learning-resources.html">
<a href="../learning-resources.html">
Learning Resources
</a>
</li>
<li class="chapter " data-level="1.9" data-path="../api/">
8 years ago
<a href="../api/">
API
</a>
</li>
8 years ago
<li class="chapter " data-level="1.10" data-path="../cli/">
8 years ago
<a href="../cli/">
CLI
</a>
</li>
8 years ago
<li class="chapter active" data-level="1.11" data-path="./">
8 years ago
<a href="./">
Contributing
</a>
<ul class="articles">
8 years ago
<li class="chapter " data-level="1.11.1" data-path="development.html">
8 years ago
8 years ago
<a href="development.html">
8 years ago
8 years ago
Development Process
8 years ago
</a>
</li>
8 years ago
<li class="chapter " data-level="1.11.2" data-path="code-of-conduct.html">
8 years ago
8 years ago
<a href="code-of-conduct.html">
8 years ago
8 years ago
Code of Conduct
8 years ago
</a>
</li>
</ul>
</li>
<li class="divider"></li>
<li>
<a href="https://www.gitbook.com" target="blank" class="gitbook-link">
Published with GitBook
</a>
</li>
</ul>
</nav>
</div>
<div class="book-body">
<div class="body-inner">
<div class="book-header" role="navigation">
<!-- Title -->
<h1>
<i class="fa fa-circle-o-notch fa-spin"></i>
<a href=".." >Contributing</a>
</h1>
</div>
<div class="page-wrapper" tabindex="-1" role="main">
<div class="page-inner">
<div id="book-search-results">
<div class="search-noresults">
<section class="normal markdown-section">
<h1 id="contributing">Contributing</h1>
<h3 id="so-you-want-to-contribute-to-neutrino">So, you want to contribute to Neutrino?</h3>
8 years ago
<p>Thank you for wanting to help out with Neutrino! We are very happy that you want to contribute, and have put together
this guide to help you get started. We want to do our best to help you make successful contributions and be part of our
community.</p>
8 years ago
<h3 id="participation-conduct">Participation Conduct</h3>
<p>In order to ensure everyone has a fair, pleasant, and inclusive experience contributing to Neutrino, we ask that you
8 years ago
abide by our <a href="code-of-conduct.html">community participation guidelines</a>, based on the
8 years ago
<a href="http://contributor-covenant.org/" target="_blank">Contributor Covenant</a>. Please read and understand it for everyone&apos;s benefit.</p>
<p>Following these guidelines helps to communicate that you respect the time of the developers managing
and developing Neutrino. In return, we will show you respect in addressing your issue, assessing changes,
and helping you finalize your pull requests.</p>
<h3 id="what-we-need">What we need</h3>
<p>There is always room for improvement and expansion in Neutrino. Some things that could always help:</p>
<ul>
<li>Triaging and fixing bugs</li>
<li>Adding tests to Neutrino which can help ensure it functions properly with new contributions</li>
<li>Keeping core presets up to date with the best Webpack and Babel options</li>
<li>Expanding documentation, writing tutorials, and creating example projects</li>
<li>Something else, of course!</li>
</ul>
<h3 id="what-we-probably-dont-need">What we probably don&apos;t need</h3>
<p>While we are happy to review <strong>any</strong> contribution, there are some things that are best left as an external project:</p>
<ul>
<li><em>Additional presets</em>. While neutrino-dev does contain a number of core presets, we created and maintain these because
they were core to most of the projects we personally work on. If there are more presets you believe should be maintained
by the core, then feel free to raise an issue and we can discuss! Most likely though, additional presets can be
externally maintained and published to npm. It still has the same reach potential as bringing it into the core, without
raising the maintenance burden for Neutrino unnecessarily.</li>
<li><em>Scaffolding and boilerplates.</em> The goal of Neutrino is to remove over-reliance on boilerplates, instead opting to
push users into consuming presets. Neutrino itself will not add commands to scaffold out new projects or create
boilerplate repositories. We do keep a collection of examples-as-documentation for getting started with Neutrino
presets, but do not wish to govern project structure more than necessary. These types of projects can be maintained
externally.</li>
</ul>
<h2 id="support">Support</h2>
<p>Neutrino team members and contributors are here to help you! Should you need assistance or have questions in using
8 years ago
Neutrino or its core presets, please consider asking on our Slack channel, Stack Overflow, or other channel rather than
filing issues. We would prefer to keep our GitHub issues clear for bugs, feature requests, discussions, and
relevant information related to its development.</p>
<p><a href="https://neutrino-slack.herokuapp.com/" target="_blank">Join our Slack channel!</a></p>
8 years ago
<h2 id="guidelines">Guidelines</h2>
<ul>
<li>Please make a good-faith effort to ensure that code that goes into neutrino-dev follows the existing patterns and
quality that is already present in the repository.</li>
<li>Create issues for any major changes and enhancements that you wish to make. Discuss things transparently and get
community feedback.</li>
<li>Strive for code to be readable. Prefer following functional programming paradigms over object-oriented ones where
possible.</li>
<li>Keep feature versions as small as possible, preferably one new feature per version.</li>
</ul>
<h2 id="getting-started">Getting started</h2>
<p>Most contributions will involve working with the neutrino-dev codebase. Please refer to the <a href="development.html">development
documentation</a> for technical details on getting started.</p>
<h2 id="filing-bugs-and-issues">Filing bugs and issues</h2>
<p>When filing an issue, try to answer these questions:</p>
<ul>
<li>What version of Neutrino are you using?</li>
<li>Are you trying to use any presets? If so, which ones, and what versions?</li>
<li>Are you using the Yarn client or the npm client? What version?</li>
<li>What version of Node.js are you using?</li>
<li>What operating system are you using?</li>
<li>What did you do?</li>
<li>What did you expect to happen?</li>
<li>What actually happened, contrary to your expectations?</li>
</ul>
<h2 id="feature-requests-or-enhancements">Feature Requests or Enhancements</h2>
<p>Please file an issue describing your request in detail:</p>
<ul>
<li>What is the goal of the change?</li>
<li>What are the pros and cons of the change?</li>
<li>Could this dramatically improve the experience of our users?</li>
</ul>
<p>Please be open to discussion, and we will respect your time by fairly evaluating your request. In the event that your
request is deemed to not be acceptable to move forward, please understand that isn&apos;t a criticism of you as a person,
but rather that the idea in its present form may not be right at this time. We respect you and your ideas, and will
always encourage contributors to continue to make proposals.</p>
<h2 id="code-review-process">Code review process</h2>
<p>Code is reviewed by Neutrino team members for quality, conformance to existing patterns, and functionality.</p>
</section>
</div>
<div class="search-results">
<div class="has-results">
<h1 class="search-results-title"><span class='search-results-count'></span> results matching "<span class='search-query'></span>"</h1>
<ul class="search-results-list"></ul>
</div>
<div class="no-results">
<h1 class="search-results-title">No results matching "<span class='search-query'></span>"</h1>
</div>
</div>
</div>
</div>
</div>
</div>
<a href="../cli/" class="navigation navigation-prev " aria-label="Previous page: CLI">
<i class="fa fa-angle-left"></i>
</a>
8 years ago
<a href="development.html" class="navigation navigation-next " aria-label="Next page: Development Process">
8 years ago
<i class="fa fa-angle-right"></i>
</a>
</div>
<script>
var gitbook = gitbook || [];
gitbook.push(function() {
8 years ago
gitbook.page.hasChanged({"page":{"title":"Contributing","level":"1.11","depth":1,"next":{"title":"Development Process","level":"1.11.1","depth":2,"path":"contributing/development.md","ref":"contributing/development.md","articles":[]},"previous":{"title":"CLI","level":"1.10","depth":1,"path":"cli/README.md","ref":"cli/README.md","articles":[]},"dir":"ltr"},"config":{"plugins":["edit-link","prism","-highlight","github","anchorjs"],"root":"./docs","styles":{"website":"styles/website.css","pdf":"styles/pdf.css","epub":"styles/epub.css","mobi":"styles/mobi.css","ebook":"styles/ebook.css","print":"styles/print.css"},"pluginsConfig":{"prism":{},"github":{"url":"https://github.com/mozilla-neutrino/neutrino-dev/"},"search":{},"lunr":{"maxIndexSize":1000000,"ignoreSpecialCharacters":false},"fontsettings":{"theme":"white","family":"sans","size":2},"sharing":{"facebook":true,"twitter":true,"google":false,"weibo":false,"instapaper":false,"vk":false,"all":["facebook","google","twitter","weibo","instapaper"]},"edit-link":{"label":"Edit page","base":"https://github.com/mozilla-neutrino/neutrino-dev/tree/master/docs"},"theme-default":{"styles":{"website":"styles/website.css","pdf":"styles/pdf.css","epub":"styles/epub.css","mobi":"styles/mobi.css","ebook":"styles/ebook.css","print":"styles/print.css"},"showLevel":false},"anchorjs":{}},"theme":"default","pdf":{"pageNumbers":true,"fontSize":12,"fontFamily":"Arial","paperSize":"a4","chapterMark":"pagebreak","pageBreaksBefore":"/","margin":{"right":62,"left":62,"top":56,"bottom":56}},"structure":{"langs":"LANGS.md","readme":"README.md","glossary":"GLOSSARY.md","summary":"SUMMARY.md"},"variables":{},"title":"Neutrino","gitbook":"*"},"file":{"path":"contributing/README.md","mtime":"2017-02-16T21:55:45.000Z","type":"markdown"},"gitbook":{"version":"3.2.2","time":"2017-02-24T17:55:14.289Z"},"basePath":"..","book":{"language":""}});
8 years ago
});
</script>
</div>
<script src="../gitbook/gitbook.js"></script>
<script src="../gitbook/theme.js"></script>
<script src="../gitbook/gitbook-plugin-edit-link/plugin.js"></script>
<script src="../gitbook/gitbook-plugin-github/plugin.js"></script>
<script src="https://cdnjs.cloudflare.com/ajax/libs/anchor-js/3.1.1/anchor.min.js"></script>
<script src="../gitbook/gitbook-plugin-anchorjs/anchor-style.js"></script>
<script src="../gitbook/gitbook-plugin-search/search-engine.js"></script>
<script src="../gitbook/gitbook-plugin-search/search.js"></script>
<script src="../gitbook/gitbook-plugin-lunr/lunr.min.js"></script>
<script src="../gitbook/gitbook-plugin-lunr/search-lunr.js"></script>
<script src="../gitbook/gitbook-plugin-sharing/buttons.js"></script>
<script src="../gitbook/gitbook-plugin-fontsettings/fontsettings.js"></script>
</body>
</html>