Grammatical Errors - Chapter 44. Case studies: instance management in OpenStack Security Guide - current

[Shellee Aragon]

The latter sentence is incomplete and should be merged with the preceding sentence also some of the verbiage is bizarre:

Bob is interested in ensuring that customers receive a high quality of service. He is concerned that providing too much explicit user control over instance scheduling could negatively impact the quality of service. So he disables this feature.

Proposed revision:

Bob is interested in ensuring that customers receive a high quality of service. He is concerned that providing excess explicit user control over instance scheduling could negatively impact the quality of service as a result, he disables this feature.

Redundant use of adverbs (Additionally, also), use of conjunctive adverb to start sentence (However) and poor verbiage:

Additionally, he also allows users to upload their own images. However, users cannot generally share their images. This helps prevent a user from sharing a malicious image, which could negatively impact the security of other users in the cloud.

Proposed revision:

Additionally, he allows users to upload their own images however, users generally cannot share their images. This helps prevent a user from sharing a malicious image, which could negatively impact the security of other users in the cloud.

Use of conjunctive adverb to start sentence (However):

For migrations, Bob wants to enable secure instance migrations in order to support rolling upgrades with minimal user downtime. Bob ensures that all migrations occur on an isolated VLAN. He plans to defer implementing encrypted migrations until this is better supported in nova client tools. However, he makes a note to track this carefully and switch to encrypted migrations as soon as possible.

Proposed revision:

For migrations, Bob wants to enable secure instance migrations in order to support rolling upgrades with minimal user downtime. Bob ensures that all migrations occur on an isolated VLAN. He plans to defer implementing encrypted migrations until this is better supported in nova client tools. As a result, he makes a note to track this carefully and switch to encrypted migrations as soon as possible.

-----------------------------------
Built: 2014-07-17T17:42:04 00:00
git SHA: c14f57c7e299c76ed1e8f26f02a4a4892657a3eb
URL: http://docs.openstack.org/security-guide/content/case-studies-instance-management.html
source File: file:/home/jenkins/workspace/security-doc-tox-doc-publishdocs/security-guide/ch_case-studies-instance-management.xml
xml:id: case-studies-instance-management

[OpenStack Infra (hudson-openstack)]

Fix proposed to branch: master
Review: https://review.openstack.org/114354

[OpenStack Infra (hudson-openstack)]

Reviewed: https://review.openstack.org/114354
Committed: https://git.openstack.org/cgit/openstack/security-doc/commit/?id=4fe0b6b548ab6c2f2f6de44c600b6884681535cc
Submitter: Jenkins
Branch: master

commit 4fe0b6b548ab6c2f2f6de44c600b6884681535cc
Author: Brad Pokorny <email address hidden>
Date: Thu Aug 14 13:42:24 2014 -0700

    Fix grammatical errors in instance management case study

    There are a few grammatical errors in the instance management case
    study. This commit fixes them.

    Co-Authored-By: Shellee Arnold <email address hidden>

    Change-Id: Ia0b62a4de4721226e6b49305f6f71cbfee26e1ae
    Closes-Bug: #1343549