{{>header}}

{{>nav this}}

	<div class="o-techdocs-main o-techdocs-content">

		<h1>Contributors' guide</h1>

		<p>The polyfill service is a community resource, designed for everyone, and welcomes contributions from everyone.</p>


		<h2 id="contribution-rewards">Contribution rewards</h2>

		<p>We want to encourage more people to get involved in the polyfill service, so the Financial Times is pleased to offer one month's free premium access to all FT content (normally $50) to anyone who has a pull request merged in this repository.  <a href="https://docs.google.com/a/ft.com/forms/d/1aykPiYBwqKpKY6nvGVi43wOU_5epr3XLgE00Vi52SMQ/viewform">Claim your free access</a>.</p>


		<h2 id='building-and-running'>Building and running the service</h2>

		<p>See the README for installation information</p>


		<h2 id="contributing-to-the-service">Contributing to the service</h2>

		<p>The service part of the project is pretty simple, and there are few strict conventions.  In lieu of any formal standards, try to take care to follow existing conventions.  Some of these are defined in <code>.editorconfig</code> and <code>.eslintrc</code> files.</p>


		<h2 id="contributing-to-the-library">Contributing to the polyfill collection</h2>

		<p>Our polyfills are where the varied talents of the open source community can make this service really great.  Consider helping us out by adding, improving, testing or configuring a polyfill.  The following detailed guides will help you get started:</p>

		<ul>
			<li><a href='/v{{apiversion}}/docs/contributing/authoring-polyfills'>Authoring polyfills</a></li>
			<li><a href='/v{{apiversion}}/docs/contributing/testing'>Testing</a></li>
			<li><a href='/v{{apiversion}}/docs/contributing/common-scenarios'>Common scenarios</a></li>
		</ul>


		<h2 id='contribution-terms'>Contribution terms</h2>

		<p>All contributions to the polyfill service are made under the MIT licence.  It is important therefore that you agree to the following when contributing code to the service:</p>

		<ul>
			<li>Any contribution I make to the polyfill service by way of Pull Request contains only data that is:
			<ul>
				<li>wholly my own work, upon which I am legally permitted to grant a licence; or</li>
				<li>wholly the work of individuals within the same organisation to which the copyright in all work created by employees is assigned, of which I am a current employee and authorised representive for the purposes of this contribution, and which is legally permitted to grant a licence; or
				<li>licensed by the original author under the MIT licence or equivalent terms</li>
			</ul>
			</li>
			<li>In respect of any part of my contribution that is not already available under an MIT or compatible licence, I hereby grant to the Financial Times Limited (FT) and to recipients of software distributed by the FT a perpetual, worldwide, non-exclusive, no-charge, royalty-free, irrevocable license to make, have made, use, offer to sell, sell, import, and otherwise transfer the data.</li>
		</ul>

		<p>It is helpful to us if you can clearly state your agreement to the above terms when creating a pull request. If you don't, you may be asked to post a followup comment to accept the terms, before we can merge your PR.</p>

	</div>

{{>footer}}