From: Anil Belur Date: Sun, 22 Jul 2018 03:55:24 +0000 (+1000) Subject: Fix typos in the docs X-Git-Url: https://gerrit.linuxfoundation.org/infra/gitweb?a=commitdiff_plain;h=560ac82789f6062f4bb53db30389191a9fafc729;p=releng%2Fdocs.git Fix typos in the docs Change-Id: Ia11013621eff187fefef56e1053d6b9eeeb058f1 Signed-off-by: Anil Belur --- diff --git a/docs/ansible.rst b/docs/ansible.rst index 7333d46..648470c 100644 --- a/docs/ansible.rst +++ b/docs/ansible.rst @@ -4,7 +4,7 @@ Ansible Guide ############# -This guide documents the process to setup and manage a new ansible role. +This guide documents the process to setup and manage a new Ansible role. .. _ansible-roles: diff --git a/docs/environment-overview.rst b/docs/environment-overview.rst index 4e663ea..9795100 100644 --- a/docs/environment-overview.rst +++ b/docs/environment-overview.rst @@ -4,7 +4,7 @@ Environment Overview #################### -Projects coming to The Linux Foundation (LF) for Continuous Integregration (CI) +Projects coming to The Linux Foundation (LF) for Continuous Integration (CI) services are generally given a similar infrastructure to the rest of our other projects unless there is a good reason to deviate from this configuration. @@ -57,7 +57,7 @@ granted via this same group. Long term storage of CI logs is not complete during this phase as the log shipping mechanisms that we use for capturing the console logs require that the CI infrastructure be open to the public. To improve the log storage, as well as -avoid potential issues with licensing for JIRA and Confluence the recomendation +avoid potential issues with licensing for JIRA and Confluence the recommendation for projects is stay in pre-formation for as short a time as possible or if possible, skip a restricted formation phased altogether. @@ -66,7 +66,7 @@ Preparation for code seeds Code contributed to a project as seed needs to meet the following criteria: -#. The code must pass any required Intelectual Property Review (IPR) that is +#. The code must pass any required Intellectual Property Review (IPR) that is in use by the project #. The code must pass any licensing requirements related to the licensing used @@ -88,7 +88,7 @@ Code contributed to a project as seed needs to meet the following criteria: LF does not presently have, nor is it aware of, tooling that will allow us to properly scan incoming repository histories to verify that they meet this. Requiring a squash commit of seed code is the way that we can - definitevly enforce this. + definitively enforce this. Post-formation ============== diff --git a/docs/gerrit.rst b/docs/gerrit.rst index fe3f289..b527e44 100644 --- a/docs/gerrit.rst +++ b/docs/gerrit.rst @@ -274,7 +274,7 @@ This method is a useful fallback in situations where we cannot use Using "heads" instead, will attempt to make the a push into the repository bypassing Gerrit which can come in handy for some isolated cases (when having force push rights). Another variable commonly used is "refs/changes/" which is an explicit - way of making an update to an exisiting gerrit. In such case, is best to let gerrit handle + way of making an update to an existing gerrit. In such case, is best to let gerrit handle this via Change-Id_ in the commit text. More options for this command: `git-push `_. diff --git a/docs/infra/bootstrap.rst b/docs/infra/bootstrap.rst index ce356a2..32950be 100644 --- a/docs/infra/bootstrap.rst +++ b/docs/infra/bootstrap.rst @@ -176,7 +176,7 @@ Bootstrap common-packer and initial builder #. Note down the image name from the packer build as we will need it later #. Navigate to ``https://jenkins.example.org/credentials/store/system/domain/_/newCredentials`` -#. Configure the openstack cloud credential as follows: +#. Configure the OpenStack cloud credential as follows: .. code-block:: none diff --git a/docs/infra/nexus.rst b/docs/infra/nexus.rst index 7ad496d..699bfe9 100644 --- a/docs/infra/nexus.rst +++ b/docs/infra/nexus.rst @@ -4,7 +4,7 @@ Nexus ##### -Nexus is an antifact repository typically used in Java / Maven projects. +Nexus is an artifact repository typically used in Java / Maven projects. Stores Project artifacts, Javadocs, and Jenkins job logs. .. _nexus-file-system: diff --git a/docs/infra/openstack.rst b/docs/infra/openstack.rst index a0d4af1..eb0551c 100644 --- a/docs/infra/openstack.rst +++ b/docs/infra/openstack.rst @@ -6,7 +6,7 @@ OpenStack Management We use OpenStack as our primary underlying cloud for CI. With the majority of the projects all hosted with the same vendor we can adopt common management -pratices across them. +practices across them. Sharing instance images ======================= diff --git a/docs/jenkins.rst b/docs/jenkins.rst index 0bc7038..7c15281 100644 --- a/docs/jenkins.rst +++ b/docs/jenkins.rst @@ -443,7 +443,7 @@ releng/builder repos. To access the Jenkins Production URL for any project use: ``https://jenkins.example.org`` -Similarily, the project's corresponding Jenkins Sandbox URL would be: +Similarly, the project's corresponding Jenkins Sandbox URL would be: ``https://jenkins.example.org/sandbox`` Any users with an LFID can access the Jenkins Production site, but for Jenkins @@ -454,19 +454,19 @@ Project contributors do not edit the Jenkins jobs directly on the Jenkins produc server. Instead, we encourage them to use the Jenkins Sandbox. The Jenkins Sandbox has similar configuration to the production instance. -Jenkins Sandbos does not publish artifacts in Nexus or Nexus3 or vote in Gerrit which +Jenkins Sandbox does not publish artifacts in Nexus or Nexus3 or vote in Gerrit which makes it a safe environment to test the jobs. Users can edit and trigger the jobs -directly to test the behaviour. +directly to test the behavior. The Jenkins Sandbox can contain dummy configuration files and dummy credentials in case it helps take the test further and not fail on the first steps due to the configuration not being present. Any attempt to actually use the configuration files in order -to make any server comunications will fail. To add dummy configuration files, please +to make any server communications will fail. To add dummy configuration files, please create a new ticket to :ref:`Helpdesk `. In such case, merge jobs, push, CLM, Docker or Sonar jobs get tested to some extent due to this limitation. Once the job template gets merged and becomes available in Jenkins Production, -we can confirm the jobs are actually making server comunications as expected with Nexus-IQ, +we can confirm the jobs are actually making server communications as expected with Nexus-IQ, Sonar, Gerrit or Nexus. The Sandbox has limited amount of Virtual Machine nodes instances