Merge pull request #6257 from ethereum/docs-testing

Add mention of docs testing to contribution docs
This commit is contained in:
chriseth 2019-03-13 12:25:34 +01:00 committed by GitHub
commit 9c9053dd49
No known key found for this signature in database
GPG Key ID: 4AEE18F83AFDEB23

View File

@ -404,4 +404,15 @@ Common Terms
Code Examples
-------------
* Ensure that all code examples begin with a ``pragma`` version that spans the largest where the contract code is valid. For example ``pragma solidity >=0.4.0 <0.7.0;``.
A CI process tests all code block formatted code examples that begin with ``pragma solidity``, ``contract``, ``library``
or ``interface`` using the ``./test/cmdlineTests.sh`` script when you create a PR. If you are adding new code examples,
ensure they work and pass tests before creating the PR.
Ensure that all code examples begin with a ``pragma`` version that spans the largest where the contract code is valid.
For example ``pragma solidity >=0.4.0 <0.7.0;``.
Running Documentation Tests
---------------------------
Make sure your contributions pass our documentation tests by running ``./scripts/docs.sh`` that installs dependencies
needed for documentation and checks for any problems such as broken links or syntax issues.