Edit ci.md

Add final edits, mostly for parallelism and consistent tense.

Author: Amanda Butler

docs/reference/contributing/guidelines/ci.md

@@ -1,32 +1,32 @@
-<h2 id="ci">Continuous integration</h2>
+<h2 id="ci">Continuous integration (CI) testing</h2>
 
-Continuous integration (CI) means mainly automatic testing for pull requests.
+Continuous integration (CI) testing is an integral part of the Mbed OS contribution workflow. CI testing refers mainly to automatic testing for pull requests.
 
 ### Travis CI
 
-In Mbed OS [Travis CI](https://travis-ci.org/ARMmbed/mbed-os) is used as primary automatic testing and checking run environment.
+Mbed OS uses [Travis CI](https://travis-ci.org/ARMmbed/mbed-os) as the primary automatic testing and checking run environment.
 
-Travis configuration is located in the [.travis.yml](https://github.com/ARMmbed/mbed-os/blob/master/.travis.yml) file in Mbed OS root directory. Mbed OS uses public travis so test results are publicly available and there are public [documentation available](https://docs.travis-ci.com/).
+Travis configuration is located in the [.travis.yml](https://github.com/ARMmbed/mbed-os/blob/master/.travis.yml) file in the Mbed OS root directory. Mbed OS uses public Travis, so [test results and documentation](https://docs.travis-ci.com/) are publicly available.
 
 #### Tests
 
-- **continuous-integration/travis-ci/pr** - Travis run main.
-- **travis-ci/astyle** - Check code style using [astyle](http://astyle.sourceforge.net/).
+- **continuous-integration/travis-ci/pr** - Travis runs main.
+- **travis-ci/astyle** - Checks code style using [astyle](http://astyle.sourceforge.net/).
 - **travis-ci/docs** - [Doxygen](http://www.doxygen.org/) and naming checks:
-   - Assert that the Doxygen build produces no warnings.
-   - Assert that all binary libraries are named correctly.
-   - Assert that all assembler files are named correctly.
-- **travis-ci/doxy-spellcheck** - Check Doxygen comments for spelling errors. Runs on header files in:
+   - Asserts the Doxygen build produces no warnings.
+   - Asserts all binary libraries are named correctly.
+   - Asserts all assembler files are named correctly.
+- **travis-ci/doxy-spellcheck** - Checks Doxygen comments for spelling errors. Runs on header files in:
    - Drivers.
    - Platform.
    - RTOS.
    - Events.
    - Features/netsocket.
-- **travis-ci/events** - Check that Mbed OS compiles and run events tests.
-- **travis-ci/gitattributestest** - Check there are no changes after clone. This checks that `.gitattributes` is used correctly.
-- **travis-ci/licence_check** - Check there is no GPL licence text in the code.
-- **travis-ci/littlefs** - Test littlefs without embedded hardware.
-- **travis-ci/tools-py2.7** - Run Python tools tests with Python 2.7.
+- **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/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.
    - Asserts that all PSA manifests in the tree are in correct form.
    - Asserts that no changes need to be made.
@@ -40,26 +40,26 @@ How it works:
 - Jenkins uses a [scripted pipeline syntax](https://jenkins.io/doc/book/pipeline/).
 - Jenkins scripts are not publicly available. There is a Jenkinsfile in the Mbed OS root folder, but that is just a trigger for tests.
 - Jenkins selects required tests dynamically based on the code changes. For example, no tests execute if only markdown (.md) files change.
-- Jenkins runs a first small number of tests to provide fast feedback, and then it runs additional tests.
+- Jenkins first runs a small number of tests to provide fast feedback, and then it runs additional tests.
 
 #### Tests
 
 - **continuous-integration/jenkins/pr-head** - Jenkins main pipeline script execution status.
-- **jenkins-ci/build-ARM** - Build Mbed OS and examples with [ARM compiler](https://developer.arm.com/products/software-development-tools/compilers/arm-compiler). Related commands:
+- **jenkins-ci/build-ARM** - Builds Mbed OS and examples with the [ARM compiler](https://developer.arm.com/products/software-development-tools/compilers/arm-compiler). Related commands:
    - `mbed test --compile -t <toolchain> -m <target> `.
    - `python -u mbed-os/tools/test/examples/examples.py compile <toolchain> --mcu <target>`.
-- **jenkins-ci/build-GCC_ARM** - Build Mbed OS and examples with GCC_ARM.
-- **jenkins-ci/build-IAR** - Build Mbed OS and examples with IAR.
-- **jenkins-ci/cloud-client-test** - Test the change with [mbed-cloud-client](https://github.com/ARMmbed/mbed-cloud-client) using the [mbed-cloud-client-example](https://github.com/ARMmbed/mbed-cloud-client-example).
-- **jenkins-ci/dynamic-memory-usage** - Report dynamic memory use compared to the master branch.
-- **jenkins-ci/exporter** - Export and build exported code. Related commands:
+- **jenkins-ci/build-GCC_ARM** - Builds Mbed OS and examples with GCC_ARM.
+- **jenkins-ci/build-IAR** - Builds Mbed OS and examples with IAR.
+- **jenkins-ci/cloud-client-test** - Tests the change with [mbed-cloud-client](https://github.com/ARMmbed/mbed-cloud-client) using the [mbed-cloud-client-example](https://github.com/ARMmbed/mbed-cloud-client-example).
+- **jenkins-ci/dynamic-memory-usage** - Reports dynamic memory use compared to the master branch.
+- **jenkins-ci/exporter** - Exports and builds exported code. Related commands:
    - `python -u mbed-os/tools/test/examples/examples.py export <exporter> --mcu <target>`.
-- **jenkins-ci/greentea-test** - Run [greentea tests](../tools/greentea-testing-applications.html).
-- **jenkins-ci/mbed2-build-ARM** - Build Mbed OS 2 with [ARM compiler](https://developer.arm.com/products/software-development-tools/compilers/arm-compiler). Related commands:
+- **jenkins-ci/greentea-test** - Runs [greentea tests](../tools/greentea-testing-applications.html).
+- **jenkins-ci/mbed2-build-ARM** - Builds Mbed OS 2 with the [ARM compiler](https://developer.arm.com/products/software-development-tools/compilers/arm-compiler). Related commands:
    - `python tools/build_release.py -p <target> -t <toolchain>`.
-- **jenkins-ci/mbed2-build-GCC_ARM** - Build Mbed OS 2 with GCC_ARM.
-- **jenkins-ci/mbed2-build-IAR** - Build Mbed OS 2 with IAR.
-- **jenkins-ci/unittests** - Run [unit tests](../tools/unit-testing.html).
-- **tools-test-linux** - Test that tools work on Linux.
-- **tools-test-mac** - Test that tools work on macOS.
-- **tools-test-windows** - Test that tools work on Windows.
+- **jenkins-ci/mbed2-build-GCC_ARM** - Builds Mbed OS 2 with GCC_ARM.
+- **jenkins-ci/mbed2-build-IAR** - Builds Mbed OS 2 with IAR.
+- **jenkins-ci/unittests** - Runs [unit tests](../tools/unit-testing.html).
+- **tools-test-linux** - Tests tools work on Linux.
+- **tools-test-mac** - Tests tools work on macOS.
+- **tools-test-windows** - Tests tools work on Windows.