From b4e38a2f3ab1f83b18d0e73601a9d07f5b1c3673 Mon Sep 17 00:00:00 2001 From: Petr Kovar Date: Wed, 18 Apr 2018 17:06:48 +0200 Subject: [PATCH] [contrib] Do not depend on non-free external style guides The IBM Style Guide free version doesn't appear to be available, so do not depend on any external non-open-source style guides, per the broader community feedback from: http://lists.openstack.org/pipermail/openstack-dev/2018-May/130562.html As for spelling references, refer to Merriam-Webster & IBM developerWorks (which is based on the formerly used IBM guide). Change-Id: I722959870277d50020e6bac540522abf302ad23b Closes-Bug: #1764851 --- .../writing-style/general-writing-guidelines.rst | 12 ++++-------- 1 file changed, 4 insertions(+), 8 deletions(-) diff --git a/doc/doc-contrib-guide/source/writing-style/general-writing-guidelines.rst b/doc/doc-contrib-guide/source/writing-style/general-writing-guidelines.rst index a78ad7c865..18d5994c98 100644 --- a/doc/doc-contrib-guide/source/writing-style/general-writing-guidelines.rst +++ b/doc/doc-contrib-guide/source/writing-style/general-writing-guidelines.rst @@ -5,19 +5,15 @@ General writing guidelines ~~~~~~~~~~~~~~~~~~~~~~~~~~ Follow these guidelines to ensure readability and consistency of the -OpenStack documentation. In addition to these guidelines, the -`IBM Style Guide `_ -is used. In case of conflicts between the IBM style guide and these -guidelines, these pages take precedence. +OpenStack documentation. Use standard English -------------------- Use standard United States (U.S.) English throughout all technical -publications. -When in doubt about the spelling of a word, consult the -`Merriam-Webster's Collegiate Dictionary` and the `IBM Style Guide -`_. +publications. When in doubt about the spelling of a word, consult the +`Merriam-Webster's Collegiate Dictionary` and the +`IBM developerWorks editorial style guide `_. .. _write_in_active_voice: