Merge pull request #1235 from 0xc0170/fix_license_check

Add license PR checks + how to run it locally

Author: Amanda Butler

docs/contributing/guidelines/ci.md

@@ -24,7 +24,7 @@ Travis configuration is located in the [.travis.yml](https://github.com/ARMmbed/
    - Features/netsocket.
 - **travis-ci/events** - Checks that Mbed OS compiles and run events tests.
 - **travis-ci/gitattributestest** - Checks there are no changes after clone. This checks that `.gitattributes` is used correctly.
-- **travis-ci/licence_check** - Checks there is no GPL license text in the code.
+- **travis-ci/licence_check** - Checks that there is only a permissive license in the files, including SPDX identifier.
 - **travis-ci/littlefs** - Tests littlefs without embedded hardware.
 - **travis-ci/tools-py2.7** - Runs Python tools tests with Python 2.7.
 - **travis-ci/psa-autogen** - Runs PSA SPM code generator.

docs/contributing/guidelines/license.md

@@ -103,6 +103,22 @@ If you decide to use a different license for your work, follow the same pattern:
 
 - If more than one license applies to the source file, use an SPDX license expression (see [SPDX Specification, Appendix IV](https://spdx.org/spdx-specification-21-web-version#h.jxpfx0ykyb60)), to reflect the presence of multiple licenses in your *LICENSE.md* file and in each source file.
 
+## License check in pull requests
+
+We use scancode-toolkit to enforce the license in binaries and libraries. Please see "Continuous integration (CI) testing" section for more information.
+
+To scan the files in the SCANCODE folder, please use:
+
+```
+scancode --license --json-pp mbed-os.json SCANCODE
+```
+
+Run our script to check if files confirm to this license guide:
+
+```
+python tools/test/travis-ci/scancode-evaluate.py -f mbed-os.json
+```
+
 ## Contributing to the Mbed OS codebase
 
 ### Mbed OS principles