)]}'
{"doc/contributor-guide/source/index.rst":[{"author":{"_account_id":14643,"name":"Olga Gusarenko","email":"ogusarenko@mirantis.com","username":"Olga"},"change_message_id":"de676da2b33cd050c1c67318987c55851e28a25f","unresolved":false,"context_lines":[{"line_number":23,"context_line":"   writing-style/word-choice.rst"},{"line_number":24,"context_line":"   writing-style/openstack-components.rst"},{"line_number":25,"context_line":"   writing-style/release-names.rst"},{"line_number":26,"context_line":"   writing-style/code-conventions.rst"},{"line_number":27,"context_line":""},{"line_number":28,"context_line":"Search in this guide"},{"line_number":29,"context_line":"~~~~~~~~~~~~~~~~~~~~"}],"source_content_type":"text/x-rst","patch_set":5,"id":"ba15a1d1_152ae62c","line":26,"updated":"2015-09-15 09:04:36.000000000","message":"Only the writing-style.rst file should be included in the toctree, and please save it to the /contibutor-guide/source directory. All the dependent files can be put to a subfolder but included in writing-style.rst","commit_id":"6e2957adacb2f83b3bcdfc081ab1b6e0e63e984f"}],"doc/contributor-guide/source/writing-style/code-conventions.rst":[{"author":{"_account_id":14962,"name":"ologvinova","email":"ologvinova@mirantis.com","username":"ologvinova"},"change_message_id":"460ffc4638361b0be985d7d54834bb974956c06f","unresolved":false,"context_lines":[{"line_number":25,"context_line":""},{"line_number":26,"context_line":"   * Tasks required to get credentials to work with ``euca2ools``"},{"line_number":27,"context_line":"   * Explanations of differences between how an Amazon EC2 and "},{"line_number":28,"context_line":"     an OpenStack endpoints function, when you access it through EC2."}],"source_content_type":"text/x-rst","patch_set":1,"id":"da20952f_009d7565","line":28,"updated":"2015-09-04 10:42:25.000000000","message":"I would omit comma before \u0027when\u0027 as it introduces essential info.","commit_id":"9ecff39ece7282cde9e3abd9e685970f0c4c5c46"},{"author":{"_account_id":9382,"name":"Shilla Saebi","email":"shilla.saebi@gmail.com","username":"shillasaebi"},"change_message_id":"2a10bd58a06a08009071891c5fa000cb5a194bdb","unresolved":false,"context_lines":[{"line_number":25,"context_line":"   When documenting ``euca2ools``, limit the content to the following topics:"},{"line_number":26,"context_line":""},{"line_number":27,"context_line":"   * Tasks required to get credentials to work with ``euca2ools``"},{"line_number":28,"context_line":"   * Explanations of differences between how an Amazon EC2 and"},{"line_number":29,"context_line":"     an OpenStack endpoints function when you access them through EC2."}],"source_content_type":"text/x-rst","patch_set":2,"id":"da20952f_c0799094","line":28,"updated":"2015-09-05 22:01:05.000000000","message":"can you change this to: \n\n\"Explain the difference between\"","commit_id":"2327d4714c50a4f71f7746f737e2509d47eaff7e"},{"author":{"_account_id":17626,"name":"Svetlana Karslioglu","email":"skarslioglu@mirantis.com","username":"svekars"},"change_message_id":"3b31de5d44f7634c3f97210cac6c218b45ac5ca5","unresolved":false,"context_lines":[{"line_number":25,"context_line":"   When documenting ``euca2ools``, limit the content to the following topics:"},{"line_number":26,"context_line":""},{"line_number":27,"context_line":"   * Tasks required to get credentials to work with ``euca2ools``"},{"line_number":28,"context_line":"   * Explanations of differences between how an Amazon EC2 and"},{"line_number":29,"context_line":"     an OpenStack endpoints function when you access them through EC2."}],"source_content_type":"text/x-rst","patch_set":2,"id":"da20952f_165c64ef","line":28,"in_reply_to":"da20952f_c0799094","updated":"2015-09-08 18:35:51.000000000","message":"Done","commit_id":"2327d4714c50a4f71f7746f737e2509d47eaff7e"},{"author":{"_account_id":6486,"name":"Brant Knudson","email":"blk@acm.org","username":"blk-u"},"change_message_id":"b2f76e34d60c6c86fdf2530073c18e12a0f323cc","unresolved":false,"context_lines":[{"line_number":13,"context_line":""},{"line_number":14,"context_line":"* **Use ``--option ARGUMENT``**"},{"line_number":15,"context_line":""},{"line_number":16,"context_line":"The OpenStack CLI commands such as keystone support both ``--option ARGUMENT``"},{"line_number":17,"context_line":"and ``--option\u003dARGUMENT``. In technical publications, use"},{"line_number":18,"context_line":"``--option ARGUMENT``."},{"line_number":19,"context_line":""}],"source_content_type":"text/x-rst","patch_set":5,"id":"da20952f_5434b848","line":16,"updated":"2015-09-10 15:48:24.000000000","message":"change \"keystone\" to \"openstack\". The keystone command is deprecated and will be removed soon.","commit_id":"6e2957adacb2f83b3bcdfc081ab1b6e0e63e984f"},{"author":{"_account_id":14396,"name":"Alexander Adamov","email":"aadamov@mirantis.com","username":"Alexander"},"change_message_id":"43eb47f00fc766b34cd806f0dae75ac8b72abd3b","unresolved":false,"context_lines":[{"line_number":25,"context_line":"   When documenting ``euca2ools``, limit the content to the following topics:"},{"line_number":26,"context_line":""},{"line_number":27,"context_line":"   * Tasks required to get credentials to work with ``euca2ools``"},{"line_number":28,"context_line":"   * Explain the difference between how an Amazon EC2 and"},{"line_number":29,"context_line":"     an OpenStack endpoints function when you access them through EC2."}],"source_content_type":"text/x-rst","patch_set":7,"id":"ba15a1d1_e7bbfa73","line":28,"updated":"2015-09-22 10:38:58.000000000","message":"Explain the difference in operation between Amazon EC2 and OpenStack endpoints when you access them through EC2.","commit_id":"ed9e093adb26ac0f1de36a051ab442b09fb6ca0f"},{"author":{"_account_id":167,"name":"Christian Berendt","email":"berendt@osism.tech","username":"berendt"},"change_message_id":"e95c58d9c7622ce4c04897fd84c6d5845346aa69","unresolved":false,"context_lines":[{"line_number":5,"context_line":""},{"line_number":6,"context_line":"Follow these guidelines:"},{"line_number":7,"context_line":""},{"line_number":8,"context_line":"* **Do not use -y for package install**"},{"line_number":9,"context_line":""},{"line_number":10,"context_line":"When you describe package installation, do not use the ``-y`` option."},{"line_number":11,"context_line":"Instead, use ``apt-get install package``, ``yum install package``, or"}],"source_content_type":"text/x-rst","patch_set":8,"id":"ba15a1d1_a20874da","line":8,"updated":"2015-09-22 18:58:22.000000000","message":"``-y``","commit_id":"27a7ea1c77d84695ec391bb71371b9ad901e9cfa"},{"author":{"_account_id":17626,"name":"Svetlana Karslioglu","email":"skarslioglu@mirantis.com","username":"svekars"},"change_message_id":"4f9fa6b1ae81cd137ab2a1fddf6614235cf71144","unresolved":false,"context_lines":[{"line_number":5,"context_line":""},{"line_number":6,"context_line":"Follow these guidelines:"},{"line_number":7,"context_line":""},{"line_number":8,"context_line":"* **Do not use -y for package install**"},{"line_number":9,"context_line":""},{"line_number":10,"context_line":"When you describe package installation, do not use the ``-y`` option."},{"line_number":11,"context_line":"Instead, use ``apt-get install package``, ``yum install package``, or"}],"source_content_type":"text/x-rst","patch_set":8,"id":"ba15a1d1_55b90d78","line":8,"in_reply_to":"ba15a1d1_a20874da","updated":"2015-09-22 20:47:34.000000000","message":"Done","commit_id":"27a7ea1c77d84695ec391bb71371b9ad901e9cfa"},{"author":{"_account_id":167,"name":"Christian Berendt","email":"berendt@osism.tech","username":"berendt"},"change_message_id":"e95c58d9c7622ce4c04897fd84c6d5845346aa69","unresolved":false,"context_lines":[{"line_number":13,"context_line":""},{"line_number":14,"context_line":"* **Use ``--option ARGUMENT``**"},{"line_number":15,"context_line":""},{"line_number":16,"context_line":"The OpenStack CLI commands such as keystone support both ``--option ARGUMENT``"},{"line_number":17,"context_line":"and ``--option\u003dARGUMENT``. In technical publications, use"},{"line_number":18,"context_line":"``--option ARGUMENT``."},{"line_number":19,"context_line":""}],"source_content_type":"text/x-rst","patch_set":8,"id":"ba15a1d1_e2fe6cad","line":16,"updated":"2015-09-22 18:58:22.000000000","message":"``keystone``","commit_id":"27a7ea1c77d84695ec391bb71371b9ad901e9cfa"},{"author":{"_account_id":17626,"name":"Svetlana Karslioglu","email":"skarslioglu@mirantis.com","username":"svekars"},"change_message_id":"4f9fa6b1ae81cd137ab2a1fddf6614235cf71144","unresolved":false,"context_lines":[{"line_number":13,"context_line":""},{"line_number":14,"context_line":"* **Use ``--option ARGUMENT``**"},{"line_number":15,"context_line":""},{"line_number":16,"context_line":"The OpenStack CLI commands such as keystone support both ``--option ARGUMENT``"},{"line_number":17,"context_line":"and ``--option\u003dARGUMENT``. In technical publications, use"},{"line_number":18,"context_line":"``--option ARGUMENT``."},{"line_number":19,"context_line":""}],"source_content_type":"text/x-rst","patch_set":8,"id":"ba15a1d1_35b6d98a","line":16,"in_reply_to":"ba15a1d1_e2fe6cad","updated":"2015-09-22 20:47:34.000000000","message":"Done","commit_id":"27a7ea1c77d84695ec391bb71371b9ad901e9cfa"},{"author":{"_account_id":167,"name":"Christian Berendt","email":"berendt@osism.tech","username":"berendt"},"change_message_id":"e95c58d9c7622ce4c04897fd84c6d5845346aa69","unresolved":false,"context_lines":[{"line_number":22,"context_line":"   Nova exposes both its own API and an EC2-compatible API. Therefore, you can"},{"line_number":23,"context_line":"   complete many tasks by using either the nova CLI or ``euca2ools``."},{"line_number":24,"context_line":""},{"line_number":25,"context_line":"   When documenting ``euca2ools``, limit the content to the following topics:"},{"line_number":26,"context_line":""},{"line_number":27,"context_line":"   * Tasks required to get credentials to work with ``euca2ools``"},{"line_number":28,"context_line":"   * Explain the difference in operation between the Amazon EC2 and"}],"source_content_type":"text/x-rst","patch_set":8,"id":"ba15a1d1_c276c83d","line":25,"updated":"2015-09-22 18:58:22.000000000","message":"I am not sure here. Should we really document the usage of the euca2ools? The EC2 API is a Stackforge project, not listed in the governance repository.","commit_id":"27a7ea1c77d84695ec391bb71371b9ad901e9cfa"},{"author":{"_account_id":17626,"name":"Svetlana Karslioglu","email":"skarslioglu@mirantis.com","username":"svekars"},"change_message_id":"4f9fa6b1ae81cd137ab2a1fddf6614235cf71144","unresolved":false,"context_lines":[{"line_number":22,"context_line":"   Nova exposes both its own API and an EC2-compatible API. Therefore, you can"},{"line_number":23,"context_line":"   complete many tasks by using either the nova CLI or ``euca2ools``."},{"line_number":24,"context_line":""},{"line_number":25,"context_line":"   When documenting ``euca2ools``, limit the content to the following topics:"},{"line_number":26,"context_line":""},{"line_number":27,"context_line":"   * Tasks required to get credentials to work with ``euca2ools``"},{"line_number":28,"context_line":"   * Explain the difference in operation between the Amazon EC2 and"}],"source_content_type":"text/x-rst","patch_set":8,"id":"ba15a1d1_95bfa55f","line":25,"in_reply_to":"ba15a1d1_c276c83d","updated":"2015-09-22 20:47:34.000000000","message":"Christian, at this point we are adding whatever is on this page: \nhttps://wiki.openstack.org/wiki/Documentation/Conventions#Code_conventions\n\nAre suggesting to remove this?","commit_id":"27a7ea1c77d84695ec391bb71371b9ad901e9cfa"},{"author":{"_account_id":10607,"name":"Alexandra Settle","email":"a.settle@outlook.com","username":"asettle"},"change_message_id":"ecba4257f2bd6fdd98bfc5cde365fc3e4c9bf8bf","unresolved":false,"context_lines":[{"line_number":22,"context_line":"   Nova exposes both its own API and an EC2-compatible API. Therefore, you can"},{"line_number":23,"context_line":"   complete many tasks by using either the nova CLI or ``euca2ools``."},{"line_number":24,"context_line":""},{"line_number":25,"context_line":"   When documenting ``euca2ools``, limit the content to the following topics:"},{"line_number":26,"context_line":""},{"line_number":27,"context_line":"   * Tasks required to get credentials to work with ``euca2ools``"},{"line_number":28,"context_line":"   * Explain the difference in operation between the Amazon EC2 and"}],"source_content_type":"text/x-rst","patch_set":10,"id":"ba15a1d1_8bbb010f","line":25,"updated":"2015-09-23 01:09:22.000000000","message":"Is this part of the note? if not, it does not need to be indented.","commit_id":"b35753b2dcd4e99224ba2377b72ca28ab1517a81"},{"author":{"_account_id":17626,"name":"Svetlana Karslioglu","email":"skarslioglu@mirantis.com","username":"svekars"},"change_message_id":"0cb468014b75dff8403583ea9499707448e568a1","unresolved":false,"context_lines":[{"line_number":22,"context_line":"   Nova exposes both its own API and an EC2-compatible API. Therefore, you can"},{"line_number":23,"context_line":"   complete many tasks by using either the nova CLI or ``euca2ools``."},{"line_number":24,"context_line":""},{"line_number":25,"context_line":"   When documenting ``euca2ools``, limit the content to the following topics:"},{"line_number":26,"context_line":""},{"line_number":27,"context_line":"   * Tasks required to get credentials to work with ``euca2ools``"},{"line_number":28,"context_line":"   * Explain the difference in operation between the Amazon EC2 and"}],"source_content_type":"text/x-rst","patch_set":10,"id":"ba15a1d1_bab70284","line":25,"in_reply_to":"ba15a1d1_8bbb010f","updated":"2015-09-23 23:09:30.000000000","message":"Alexandra, this text is in the wiki, that\u0027s why I added it here. I can remove it if needed.","commit_id":"b35753b2dcd4e99224ba2377b72ca28ab1517a81"},{"author":{"_account_id":10497,"name":"KATO Tomoyuki","email":"kato.tomoyuki@jp.fujitsu.com","username":"to222"},"change_message_id":"0745fc5c2369b31fc96742b353ab7033200a739c","unresolved":false,"context_lines":[{"line_number":22,"context_line":"   Nova exposes both its own API and an EC2-compatible API. Therefore, you can"},{"line_number":23,"context_line":"   complete many tasks by using either the nova CLI or ``euca2ools``."},{"line_number":24,"context_line":""},{"line_number":25,"context_line":"When documenting ``euca2ools``, limit the content to the following topics:"},{"line_number":26,"context_line":""},{"line_number":27,"context_line":" * Tasks required to get credentials to work with ``euca2ools``"},{"line_number":28,"context_line":" * Explain the difference in operation between the Amazon EC2 and"}],"source_content_type":"text/x-rst","patch_set":12,"id":"9a1a9d01_3ef37b75","line":25,"updated":"2015-09-24 22:22:01.000000000","message":"For Liberty, we disable EC2-compatible API by default. So, we need to rewrite. But this is good as starting point.","commit_id":"866af897271c17d18d2577972cf53b3e2e9a7780"}],"doc/contributor-guide/source/writing-style/general-writing-guidelines.rst":[{"author":{"_account_id":14962,"name":"ologvinova","email":"ologvinova@mirantis.com","username":"ologvinova"},"change_message_id":"460ffc4638361b0be985d7d54834bb974956c06f","unresolved":false,"context_lines":[{"line_number":15,"context_line":"When in doubt about a spelling, consult the `Merriam-Webster\u0027s"},{"line_number":16,"context_line":"Collegiate Dictionary`."},{"line_number":17,"context_line":""},{"line_number":18,"context_line":"Write in Active Voice"},{"line_number":19,"context_line":"---------------------"},{"line_number":20,"context_line":""},{"line_number":21,"context_line":"In general, write in active voice rather than passive voice."}],"source_content_type":"text/x-rst","patch_set":1,"id":"da20952f_00d9f521","line":18,"updated":"2015-09-04 10:42:25.000000000","message":"sentence case capitalization in titles. Please change in all the docs of your patch.","commit_id":"9ecff39ece7282cde9e3abd9e685970f0c4c5c46"},{"author":{"_account_id":14962,"name":"ologvinova","email":"ologvinova@mirantis.com","username":"ologvinova"},"change_message_id":"460ffc4638361b0be985d7d54834bb974956c06f","unresolved":false,"context_lines":[{"line_number":31,"context_line":"from those of the user. In addition, passive voice usually requires more"},{"line_number":32,"context_line":"words than active voice."},{"line_number":33,"context_line":""},{"line_number":34,"context_line":"**Example:**"},{"line_number":35,"context_line":""},{"line_number":36,"context_line":"::"},{"line_number":37,"context_line":""}],"source_content_type":"text/x-rst","patch_set":1,"id":"da20952f_e07f21de","line":34,"updated":"2015-09-04 10:42:25.000000000","message":"It\u0027s not clear whether these are good or bad examples, unless a user reads the above paragraph.","commit_id":"9ecff39ece7282cde9e3abd9e685970f0c4c5c46"},{"author":{"_account_id":14962,"name":"ologvinova","email":"ologvinova@mirantis.com","username":"ologvinova"},"change_message_id":"460ffc4638361b0be985d7d54834bb974956c06f","unresolved":false,"context_lines":[{"line_number":33,"context_line":""},{"line_number":34,"context_line":"**Example:**"},{"line_number":35,"context_line":""},{"line_number":36,"context_line":"::"},{"line_number":37,"context_line":""},{"line_number":38,"context_line":"  After you install the software, start the computer."},{"line_number":39,"context_line":"  Click OK to save the configuration."}],"source_content_type":"text/x-rst","patch_set":1,"id":"da20952f_8032e55c","line":36,"updated":"2015-09-04 10:42:25.000000000","message":"Such examples in code-blocks don\u0027t look nice. I would prefer a table with 2 columns instead: good and bad examples. Please apply to all the docs in your patch.","commit_id":"9ecff39ece7282cde9e3abd9e685970f0c4c5c46"},{"author":{"_account_id":14962,"name":"ologvinova","email":"ologvinova@mirantis.com","username":"ologvinova"},"change_message_id":"460ffc4638361b0be985d7d54834bb974956c06f","unresolved":false,"context_lines":[{"line_number":56,"context_line":"* The agent of action is unknown, or you want to de-emphasize the agent of"},{"line_number":57,"context_line":"  action and emphasize the object on which the action is performed."},{"line_number":58,"context_line":""},{"line_number":59,"context_line":"* Recasting the sentence in active voice is wordy or awkward."},{"line_number":60,"context_line":""},{"line_number":61,"context_line":"Use present simple tense"},{"line_number":62,"context_line":"------------------------"}],"source_content_type":"text/x-rst","patch_set":1,"id":"da20952f_a05cc97d","line":59,"updated":"2015-09-04 10:42:25.000000000","message":"Can you add examples here?","commit_id":"9ecff39ece7282cde9e3abd9e685970f0c4c5c46"},{"author":{"_account_id":14962,"name":"ologvinova","email":"ologvinova@mirantis.com","username":"ologvinova"},"change_message_id":"460ffc4638361b0be985d7d54834bb974956c06f","unresolved":false,"context_lines":[{"line_number":72,"context_line":"Write in second person"},{"line_number":73,"context_line":"----------------------"},{"line_number":74,"context_line":""},{"line_number":75,"context_line":"Users are more engaged with documentation when you use second person (that is,"},{"line_number":76,"context_line":"you address the user as you). Second person promotes a friendly tone by"},{"line_number":77,"context_line":"addressing users directly. Using second person with the imperative mood (in"},{"line_number":78,"context_line":"which the subject you is understood) and active voice helps to eliminate"}],"source_content_type":"text/x-rst","patch_set":1,"id":"da20952f_43b13746","line":75,"updated":"2015-09-04 10:42:25.000000000","message":"I would make a bullet list from 2 paragraphs below (lines 75-85) to make the info more readable.","commit_id":"9ecff39ece7282cde9e3abd9e685970f0c4c5c46"},{"author":{"_account_id":14962,"name":"ologvinova","email":"ologvinova@mirantis.com","username":"ologvinova"},"change_message_id":"460ffc4638361b0be985d7d54834bb974956c06f","unresolved":false,"context_lines":[{"line_number":86,"context_line":""},{"line_number":87,"context_line":"Use first person plural pronouns (we, our) judiciously. These pronouns"},{"line_number":88,"context_line":"emphasize the writer or OpenStack rather than the user, so before you use"},{"line_number":89,"context_line":"them, consider whether second person or imperative mood is more \"user friendly.\""},{"line_number":90,"context_line":"However, use `we recommend` rather than `it is recommended` or `OpenStack"},{"line_number":91,"context_line":"recommends`."},{"line_number":92,"context_line":"Also, you can use we in the place of OpenStack if necessary."}],"source_content_type":"text/x-rst","patch_set":1,"id":"da20952f_634a3b28","line":89,"updated":"2015-09-04 10:42:25.000000000","message":"user friendly -\u003e user-friendly","commit_id":"9ecff39ece7282cde9e3abd9e685970f0c4c5c46"},{"author":{"_account_id":14962,"name":"ologvinova","email":"ologvinova@mirantis.com","username":"ologvinova"},"change_message_id":"460ffc4638361b0be985d7d54834bb974956c06f","unresolved":false,"context_lines":[{"line_number":89,"context_line":"them, consider whether second person or imperative mood is more \"user friendly.\""},{"line_number":90,"context_line":"However, use `we recommend` rather than `it is recommended` or `OpenStack"},{"line_number":91,"context_line":"recommends`."},{"line_number":92,"context_line":"Also, you can use we in the place of OpenStack if necessary."},{"line_number":93,"context_line":""},{"line_number":94,"context_line":"Do not use first person to avoid naming the product or to avoid using passive"},{"line_number":95,"context_line":"voice. If the product is performing the action, use third person (the product"}],"source_content_type":"text/x-rst","patch_set":1,"id":"da20952f_40ddadde","line":92,"updated":"2015-09-04 10:42:25.000000000","message":"use we -\u003e use `we`","commit_id":"9ecff39ece7282cde9e3abd9e685970f0c4c5c46"},{"author":{"_account_id":14962,"name":"ologvinova","email":"ologvinova@mirantis.com","username":"ologvinova"},"change_message_id":"460ffc4638361b0be985d7d54834bb974956c06f","unresolved":false,"context_lines":[{"line_number":96,"context_line":"as actor). If you want to de-emphasize the agent of action and emphasize the"},{"line_number":97,"context_line":"object on which the action is performed, use passive voice."},{"line_number":98,"context_line":""},{"line_number":99,"context_line":"The first-person singular pronoun I is acceptable in the question part of FAQs"},{"line_number":100,"context_line":"and when authors of blogs or signed articles are describing their own actions"},{"line_number":101,"context_line":"or opinions."},{"line_number":102,"context_line":""}],"source_content_type":"text/x-rst","patch_set":1,"id":"da20952f_83b18f03","line":99,"updated":"2015-09-04 10:42:25.000000000","message":"pronoun I -\u003e pronoun `I` (italic for clarity)","commit_id":"9ecff39ece7282cde9e3abd9e685970f0c4c5c46"},{"author":{"_account_id":17626,"name":"Svetlana Karslioglu","email":"skarslioglu@mirantis.com","username":"svekars"},"change_message_id":"f6cc28edcaca788fab2c7ec7cf30a41eeba56880","unresolved":false,"context_lines":[{"line_number":96,"context_line":"as actor). If you want to de-emphasize the agent of action and emphasize the"},{"line_number":97,"context_line":"object on which the action is performed, use passive voice."},{"line_number":98,"context_line":""},{"line_number":99,"context_line":"The first-person singular pronoun I is acceptable in the question part of FAQs"},{"line_number":100,"context_line":"and when authors of blogs or signed articles are describing their own actions"},{"line_number":101,"context_line":"or opinions."},{"line_number":102,"context_line":""}],"source_content_type":"text/x-rst","patch_set":1,"id":"da20952f_44a4cfa4","line":99,"in_reply_to":"da20952f_83b18f03","updated":"2015-09-04 18:41:45.000000000","message":"Done","commit_id":"9ecff39ece7282cde9e3abd9e685970f0c4c5c46"},{"author":{"_account_id":14962,"name":"ologvinova","email":"ologvinova@mirantis.com","username":"ologvinova"},"change_message_id":"460ffc4638361b0be985d7d54834bb974956c06f","unresolved":false,"context_lines":[{"line_number":114,"context_line":"::"},{"line_number":115,"context_line":""},{"line_number":116,"context_line":"  To create a server, you specify a name, flavor, and image."},{"line_number":117,"context_line":"  To create a server, specify a name, flavor, and image. (imperative mood)"},{"line_number":118,"context_line":""},{"line_number":119,"context_line":"Use appropriate mood"},{"line_number":120,"context_line":"--------------------"}],"source_content_type":"text/x-rst","patch_set":1,"id":"da20952f_e38e4b2d","line":117,"updated":"2015-09-04 10:42:25.000000000","message":"You duplicate the same examples here.","commit_id":"9ecff39ece7282cde9e3abd9e685970f0c4c5c46"},{"author":{"_account_id":17626,"name":"Svetlana Karslioglu","email":"skarslioglu@mirantis.com","username":"svekars"},"change_message_id":"f6cc28edcaca788fab2c7ec7cf30a41eeba56880","unresolved":false,"context_lines":[{"line_number":114,"context_line":"::"},{"line_number":115,"context_line":""},{"line_number":116,"context_line":"  To create a server, you specify a name, flavor, and image."},{"line_number":117,"context_line":"  To create a server, specify a name, flavor, and image. (imperative mood)"},{"line_number":118,"context_line":""},{"line_number":119,"context_line":"Use appropriate mood"},{"line_number":120,"context_line":"--------------------"}],"source_content_type":"text/x-rst","patch_set":1,"id":"da20952f_24999b79","line":117,"in_reply_to":"da20952f_e38e4b2d","updated":"2015-09-04 18:41:45.000000000","message":"Good catch!","commit_id":"9ecff39ece7282cde9e3abd9e685970f0c4c5c46"},{"author":{"_account_id":14962,"name":"ologvinova","email":"ologvinova@mirantis.com","username":"ologvinova"},"change_message_id":"460ffc4638361b0be985d7d54834bb974956c06f","unresolved":false,"context_lines":[{"line_number":123,"context_line":""},{"line_number":124,"context_line":"**Example:** "},{"line_number":125,"context_line":""},{"line_number":126,"context_line":"Start the installation by pressing **Enter**."},{"line_number":127,"context_line":""},{"line_number":128,"context_line":"For explanations, use indicative mood."},{"line_number":129,"context_line":""}],"source_content_type":"text/x-rst","patch_set":1,"id":"da20952f_83098f86","line":126,"updated":"2015-09-04 10:42:25.000000000","message":"Maybe we should add bad examples here (and below) to be consistent with the whole doc?","commit_id":"9ecff39ece7282cde9e3abd9e685970f0c4c5c46"},{"author":{"_account_id":14962,"name":"ologvinova","email":"ologvinova@mirantis.com","username":"ologvinova"},"change_message_id":"460ffc4638361b0be985d7d54834bb974956c06f","unresolved":false,"context_lines":[{"line_number":203,"context_line":"+------------------------+----------------------------------+"},{"line_number":204,"context_line":"|Fatal                   |Serious                           |"},{"line_number":205,"context_line":"+------------------------+----------------------------------+"},{"line_number":206,"context_line":"|Error                   |Problem                           |"},{"line_number":207,"context_line":"+------------------------+----------------------------------+"},{"line_number":208,"context_line":"|Destroy                 |Remove                            |"},{"line_number":209,"context_line":"+------------------------+----------------------------------+"}],"source_content_type":"text/x-rst","patch_set":1,"id":"da20952f_63af9b2a","line":206,"updated":"2015-09-04 10:42:25.000000000","message":"Not sure whether these 2 words are synonyms.","commit_id":"9ecff39ece7282cde9e3abd9e685970f0c4c5c46"},{"author":{"_account_id":17626,"name":"Svetlana Karslioglu","email":"skarslioglu@mirantis.com","username":"svekars"},"change_message_id":"f6cc28edcaca788fab2c7ec7cf30a41eeba56880","unresolved":false,"context_lines":[{"line_number":203,"context_line":"+------------------------+----------------------------------+"},{"line_number":204,"context_line":"|Fatal                   |Serious                           |"},{"line_number":205,"context_line":"+------------------------+----------------------------------+"},{"line_number":206,"context_line":"|Error                   |Problem                           |"},{"line_number":207,"context_line":"+------------------------+----------------------------------+"},{"line_number":208,"context_line":"|Destroy                 |Remove                            |"},{"line_number":209,"context_line":"+------------------------+----------------------------------+"}],"source_content_type":"text/x-rst","patch_set":1,"id":"da20952f_a4accb9f","line":206,"in_reply_to":"da20952f_63af9b2a","updated":"2015-09-04 18:41:45.000000000","message":"They are. However, error sounds slightly more negative than problem.","commit_id":"9ecff39ece7282cde9e3abd9e685970f0c4c5c46"},{"author":{"_account_id":14962,"name":"ologvinova","email":"ologvinova@mirantis.com","username":"ologvinova"},"change_message_id":"460ffc4638361b0be985d7d54834bb974956c06f","unresolved":false,"context_lines":[{"line_number":300,"context_line":"-----------------------------"},{"line_number":301,"context_line":""},{"line_number":302,"context_line":"Do not use `please` and `thank you` in technical documentation and"},{"line_number":303,"context_line":"error messages."}],"source_content_type":"text/x-rst","patch_set":1,"id":"da20952f_16461f4f","line":303,"updated":"2015-09-04 10:42:25.000000000","message":"Can we remove \u0027and error messages\u0027 in this sentence? Not sure how it applies.","commit_id":"9ecff39ece7282cde9e3abd9e685970f0c4c5c46"},{"author":{"_account_id":12847,"name":"Sheena Gregson","email":"sgregson@mirantis.com","username":"shenzorz"},"change_message_id":"947be71c965ccce827cc6b205ab9b07340b3ddbb","unresolved":false,"context_lines":[{"line_number":36,"context_line":"+---------------------------------+------------------------------------+"},{"line_number":37,"context_line":"| **Do not use**                  | **Use**                            |"},{"line_number":38,"context_line":"+\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d+\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d+"},{"line_number":39,"context_line":"| After the software hass been    | After you install the software,    |"},{"line_number":40,"context_line":"| installed, the computer can be  | start the computer.                |"},{"line_number":41,"context_line":"| started.                        |                                    |"},{"line_number":42,"context_line":"+---------------------------------+------------------------------------+"}],"source_content_type":"text/x-rst","patch_set":2,"id":"da20952f_ad034341","line":39,"updated":"2015-09-04 21:47:14.000000000","message":"hass -\u003e has","commit_id":"2327d4714c50a4f71f7746f737e2509d47eaff7e"},{"author":{"_account_id":17626,"name":"Svetlana Karslioglu","email":"skarslioglu@mirantis.com","username":"svekars"},"change_message_id":"3b31de5d44f7634c3f97210cac6c218b45ac5ca5","unresolved":false,"context_lines":[{"line_number":36,"context_line":"+---------------------------------+------------------------------------+"},{"line_number":37,"context_line":"| **Do not use**                  | **Use**                            |"},{"line_number":38,"context_line":"+\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d+\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d+"},{"line_number":39,"context_line":"| After the software hass been    | After you install the software,    |"},{"line_number":40,"context_line":"| installed, the computer can be  | start the computer.                |"},{"line_number":41,"context_line":"| started.                        |                                    |"},{"line_number":42,"context_line":"+---------------------------------+------------------------------------+"}],"source_content_type":"text/x-rst","patch_set":2,"id":"da20952f_b6c5783e","line":39,"in_reply_to":"da20952f_ad034341","updated":"2015-09-08 18:35:51.000000000","message":"Done","commit_id":"2327d4714c50a4f71f7746f737e2509d47eaff7e"},{"author":{"_account_id":12847,"name":"Sheena Gregson","email":"sgregson@mirantis.com","username":"shenzorz"},"change_message_id":"947be71c965ccce827cc6b205ab9b07340b3ddbb","unresolved":false,"context_lines":[{"line_number":55,"context_line":"+---------------------------------+------------------------------------+"},{"line_number":56,"context_line":"| **Do not use**                  | **Use**                            |"},{"line_number":57,"context_line":"+\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d+\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d+"},{"line_number":58,"context_line":"| Your actions resulted in error. | An error occured.                  |"},{"line_number":59,"context_line":"+---------------------------------+------------------------------------+"},{"line_number":60,"context_line":""},{"line_number":61,"context_line":"* The agent of action is unknown, or you want to de-emphasize the agent of"}],"source_content_type":"text/x-rst","patch_set":2,"id":"da20952f_2dbdf367","line":58,"updated":"2015-09-04 21:47:14.000000000","message":"occured -\u003e occurred","commit_id":"2327d4714c50a4f71f7746f737e2509d47eaff7e"},{"author":{"_account_id":17626,"name":"Svetlana Karslioglu","email":"skarslioglu@mirantis.com","username":"svekars"},"change_message_id":"3b31de5d44f7634c3f97210cac6c218b45ac5ca5","unresolved":false,"context_lines":[{"line_number":55,"context_line":"+---------------------------------+------------------------------------+"},{"line_number":56,"context_line":"| **Do not use**                  | **Use**                            |"},{"line_number":57,"context_line":"+\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d+\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d+"},{"line_number":58,"context_line":"| Your actions resulted in error. | An error occured.                  |"},{"line_number":59,"context_line":"+---------------------------------+------------------------------------+"},{"line_number":60,"context_line":""},{"line_number":61,"context_line":"* The agent of action is unknown, or you want to de-emphasize the agent of"}],"source_content_type":"text/x-rst","patch_set":2,"id":"da20952f_96c87458","line":58,"in_reply_to":"da20952f_2dbdf367","updated":"2015-09-08 18:35:51.000000000","message":"Done","commit_id":"2327d4714c50a4f71f7746f737e2509d47eaff7e"},{"author":{"_account_id":12847,"name":"Sheena Gregson","email":"sgregson@mirantis.com","username":"shenzorz"},"change_message_id":"947be71c965ccce827cc6b205ab9b07340b3ddbb","unresolved":false,"context_lines":[{"line_number":64,"context_line":"+---------------------------------+------------------------------------+"},{"line_number":65,"context_line":"| **Do not use**                  | **Use**                            |"},{"line_number":66,"context_line":"+\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d+\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d+"},{"line_number":67,"context_line":"| Something caused multiple errors| Multiple errors occured during the |"},{"line_number":68,"context_line":"| during the installation.        | installation.                      |"},{"line_number":69,"context_line":"+---------------------------------+------------------------------------+"},{"line_number":70,"context_line":""}],"source_content_type":"text/x-rst","patch_set":2,"id":"da20952f_8d8d1fd5","line":67,"updated":"2015-09-04 21:47:14.000000000","message":"occured -\u003e occurred","commit_id":"2327d4714c50a4f71f7746f737e2509d47eaff7e"},{"author":{"_account_id":17626,"name":"Svetlana Karslioglu","email":"skarslioglu@mirantis.com","username":"svekars"},"change_message_id":"3b31de5d44f7634c3f97210cac6c218b45ac5ca5","unresolved":false,"context_lines":[{"line_number":64,"context_line":"+---------------------------------+------------------------------------+"},{"line_number":65,"context_line":"| **Do not use**                  | **Use**                            |"},{"line_number":66,"context_line":"+\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d+\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d+"},{"line_number":67,"context_line":"| Something caused multiple errors| Multiple errors occured during the |"},{"line_number":68,"context_line":"| during the installation.        | installation.                      |"},{"line_number":69,"context_line":"+---------------------------------+------------------------------------+"},{"line_number":70,"context_line":""}],"source_content_type":"text/x-rst","patch_set":2,"id":"da20952f_f6b210e5","line":67,"in_reply_to":"da20952f_8d8d1fd5","updated":"2015-09-08 18:35:51.000000000","message":"Done","commit_id":"2327d4714c50a4f71f7746f737e2509d47eaff7e"},{"author":{"_account_id":12847,"name":"Sheena Gregson","email":"sgregson@mirantis.com","username":"shenzorz"},"change_message_id":"947be71c965ccce827cc6b205ab9b07340b3ddbb","unresolved":false,"context_lines":[{"line_number":130,"context_line":"+-----------------------------------+------------------------------------+"},{"line_number":131,"context_line":"| **Do not use**                    | **Use**                            |"},{"line_number":132,"context_line":"+\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d+\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d+"},{"line_number":133,"context_line":"| To create a server, you specify a | To creat a sserver, specify a name,|"},{"line_number":134,"context_line":"| name, flavor, and image.          | flavor, and image. (imperative     |"},{"line_number":135,"context_line":"|                                   | mood).                             |"},{"line_number":136,"context_line":"+-----------------------------------+------------------------------------+"}],"source_content_type":"text/x-rst","patch_set":2,"id":"da20952f_ed37fbfb","line":133,"updated":"2015-09-04 21:47:14.000000000","message":"creat -\u003e create sserver -\u003e server","commit_id":"2327d4714c50a4f71f7746f737e2509d47eaff7e"},{"author":{"_account_id":17626,"name":"Svetlana Karslioglu","email":"skarslioglu@mirantis.com","username":"svekars"},"change_message_id":"3b31de5d44f7634c3f97210cac6c218b45ac5ca5","unresolved":false,"context_lines":[{"line_number":130,"context_line":"+-----------------------------------+------------------------------------+"},{"line_number":131,"context_line":"| **Do not use**                    | **Use**                            |"},{"line_number":132,"context_line":"+\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d+\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d+"},{"line_number":133,"context_line":"| To create a server, you specify a | To creat a sserver, specify a name,|"},{"line_number":134,"context_line":"| name, flavor, and image.          | flavor, and image. (imperative     |"},{"line_number":135,"context_line":"|                                   | mood).                             |"},{"line_number":136,"context_line":"+-----------------------------------+------------------------------------+"}],"source_content_type":"text/x-rst","patch_set":2,"id":"da20952f_16b464d2","line":133,"in_reply_to":"da20952f_ed37fbfb","updated":"2015-09-08 18:35:51.000000000","message":"Done","commit_id":"2327d4714c50a4f71f7746f737e2509d47eaff7e"},{"author":{"_account_id":12847,"name":"Sheena Gregson","email":"sgregson@mirantis.com","username":"shenzorz"},"change_message_id":"947be71c965ccce827cc6b205ab9b07340b3ddbb","unresolved":false,"context_lines":[{"line_number":158,"context_line":"+-------------------------------------+------------------------------------+"},{"line_number":159,"context_line":"| **Do not use**                      | **Use**                            |"},{"line_number":160,"context_line":"+\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d+\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d+"},{"line_number":161,"context_line":"| If you were to install Fuel...      | If you want to install Fuel...     |"},{"line_number":162,"context_line":"| (Implied: but you are not)          |                                    |"},{"line_number":163,"context_line":"+-------------------------------------+------------------------------------+"},{"line_number":164,"context_line":""}],"source_content_type":"text/x-rst","patch_set":2,"id":"da20952f_ed0e1b3c","line":161,"updated":"2015-09-04 21:47:14.000000000","message":"Do we want to reference Fuel here?  It\u0027s technically not an OpenStack project yet.","commit_id":"2327d4714c50a4f71f7746f737e2509d47eaff7e"},{"author":{"_account_id":17626,"name":"Svetlana Karslioglu","email":"skarslioglu@mirantis.com","username":"svekars"},"change_message_id":"3b31de5d44f7634c3f97210cac6c218b45ac5ca5","unresolved":false,"context_lines":[{"line_number":158,"context_line":"+-------------------------------------+------------------------------------+"},{"line_number":159,"context_line":"| **Do not use**                      | **Use**                            |"},{"line_number":160,"context_line":"+\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d+\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d+"},{"line_number":161,"context_line":"| If you were to install Fuel...      | If you want to install Fuel...     |"},{"line_number":162,"context_line":"| (Implied: but you are not)          |                                    |"},{"line_number":163,"context_line":"+-------------------------------------+------------------------------------+"},{"line_number":164,"context_line":""}],"source_content_type":"text/x-rst","patch_set":2,"id":"da20952f_56abbc75","line":161,"in_reply_to":"da20952f_ed0e1b3c","updated":"2015-09-08 18:35:51.000000000","message":"Done","commit_id":"2327d4714c50a4f71f7746f737e2509d47eaff7e"},{"author":{"_account_id":12847,"name":"Sheena Gregson","email":"sgregson@mirantis.com","username":"shenzorz"},"change_message_id":"947be71c965ccce827cc6b205ab9b07340b3ddbb","unresolved":false,"context_lines":[{"line_number":214,"context_line":"+------------------------+----------------------------------+"},{"line_number":215,"context_line":"| catastrophic           | serious                          |"},{"line_number":216,"context_line":"+------------------------+----------------------------------+"},{"line_number":217,"context_line":"| Bad                    | Use `serious` or add explanation.|"},{"line_number":218,"context_line":"+------------------------+----------------------------------+"},{"line_number":219,"context_line":"| fail                   | unable to                        |"},{"line_number":220,"context_line":"+------------------------+----------------------------------+"}],"source_content_type":"text/x-rst","patch_set":2,"id":"da20952f_282721b7","line":217,"updated":"2015-09-04 21:47:14.000000000","message":"Bad -\u003e bad Use -\u003e use remove period at end of \"explanation\" to show consistent formatting in the table","commit_id":"2327d4714c50a4f71f7746f737e2509d47eaff7e"},{"author":{"_account_id":17626,"name":"Svetlana Karslioglu","email":"skarslioglu@mirantis.com","username":"svekars"},"change_message_id":"3b31de5d44f7634c3f97210cac6c218b45ac5ca5","unresolved":false,"context_lines":[{"line_number":214,"context_line":"+------------------------+----------------------------------+"},{"line_number":215,"context_line":"| catastrophic           | serious                          |"},{"line_number":216,"context_line":"+------------------------+----------------------------------+"},{"line_number":217,"context_line":"| Bad                    | Use `serious` or add explanation.|"},{"line_number":218,"context_line":"+------------------------+----------------------------------+"},{"line_number":219,"context_line":"| fail                   | unable to                        |"},{"line_number":220,"context_line":"+------------------------+----------------------------------+"}],"source_content_type":"text/x-rst","patch_set":2,"id":"da20952f_f69bf064","line":217,"in_reply_to":"da20952f_282721b7","updated":"2015-09-08 18:35:51.000000000","message":"Done","commit_id":"2327d4714c50a4f71f7746f737e2509d47eaff7e"},{"author":{"_account_id":10705,"name":"Darren Chan","email":"dazzachan@yahoo.com.au","username":"daz"},"change_message_id":"2bbda25f1ff2aa8110b79c0a2add1598d0e49c45","unresolved":false,"context_lines":[{"line_number":12,"context_line":""},{"line_number":13,"context_line":"Use standard United States (U.S.) English throughout all technical"},{"line_number":14,"context_line":"publications."},{"line_number":15,"context_line":"When in doubt about a spelling, consult the `Merriam-Webster\u0027s"},{"line_number":16,"context_line":"Collegiate Dictionary`."},{"line_number":17,"context_line":""},{"line_number":18,"context_line":"Write in active voice"}],"source_content_type":"text/x-rst","patch_set":4,"id":"da20952f_4fb22d08","line":15,"updated":"2015-09-09 01:09:05.000000000","message":"s/a spelling/the spelling of a word\n\nI suggest mentioning the IBM Style Guide for conventions, as described here: https://wiki.openstack.org/wiki/Documentation/Conventions","commit_id":"8a3919d81cde60a62fc930209b93ba695976a6da"},{"author":{"_account_id":14962,"name":"ologvinova","email":"ologvinova@mirantis.com","username":"ologvinova"},"change_message_id":"1d95fe14c4307462f3070afac2a69acc0eaca2c2","unresolved":false,"context_lines":[{"line_number":32,"context_line":"from those of the user. In addition, passive voice usually requires more"},{"line_number":33,"context_line":"words than active voice."},{"line_number":34,"context_line":""},{"line_number":35,"context_line":"**Example:**"},{"line_number":36,"context_line":""},{"line_number":37,"context_line":"+---------------------------------+------------------------------------+"},{"line_number":38,"context_line":"| **Do not use**                  | **Use**                            |"}],"source_content_type":"text/x-rst","patch_set":7,"id":"ba15a1d1_61203a4a","line":35,"updated":"2015-09-22 14:22:21.000000000","message":"Can we remove the word  **Example:** (throughout the doc)? It\u0027s obvious that the below table contains examples.","commit_id":"ed9e093adb26ac0f1de36a051ab442b09fb6ca0f"},{"author":{"_account_id":17626,"name":"Svetlana Karslioglu","email":"skarslioglu@mirantis.com","username":"svekars"},"change_message_id":"239670e45f7853e89d8d8e8ee449340e9cc859df","unresolved":false,"context_lines":[{"line_number":32,"context_line":"from those of the user. In addition, passive voice usually requires more"},{"line_number":33,"context_line":"words than active voice."},{"line_number":34,"context_line":""},{"line_number":35,"context_line":"**Example:**"},{"line_number":36,"context_line":""},{"line_number":37,"context_line":"+---------------------------------+------------------------------------+"},{"line_number":38,"context_line":"| **Do not use**                  | **Use**                            |"}],"source_content_type":"text/x-rst","patch_set":7,"id":"ba15a1d1_8d5d6a7b","line":35,"in_reply_to":"ba15a1d1_61203a4a","updated":"2015-09-22 17:56:29.000000000","message":"Usually tables have titles, therefore, I think we should leave this here.","commit_id":"ed9e093adb26ac0f1de36a051ab442b09fb6ca0f"},{"author":{"_account_id":14962,"name":"ologvinova","email":"ologvinova@mirantis.com","username":"ologvinova"},"change_message_id":"a60a89d52f44c920e2b7633805fcd105b776af92","unresolved":false,"context_lines":[{"line_number":32,"context_line":"from those of the user. In addition, passive voice usually requires more"},{"line_number":33,"context_line":"words than active voice."},{"line_number":34,"context_line":""},{"line_number":35,"context_line":"**Example:**"},{"line_number":36,"context_line":""},{"line_number":37,"context_line":"+---------------------------------+------------------------------------+"},{"line_number":38,"context_line":"| **Do not use**                  | **Use**                            |"}],"source_content_type":"text/x-rst","patch_set":7,"id":"ba15a1d1_82319e5c","line":35,"in_reply_to":"ba15a1d1_8d5d6a7b","updated":"2015-09-23 09:05:56.000000000","message":"Ok, if we decide to name such small tables, I guess we need to numerate them as well.","commit_id":"ed9e093adb26ac0f1de36a051ab442b09fb6ca0f"},{"author":{"_account_id":14962,"name":"ologvinova","email":"ologvinova@mirantis.com","username":"ologvinova"},"change_message_id":"1d95fe14c4307462f3070afac2a69acc0eaca2c2","unresolved":false,"context_lines":[{"line_number":35,"context_line":"**Example:**"},{"line_number":36,"context_line":""},{"line_number":37,"context_line":"+---------------------------------+------------------------------------+"},{"line_number":38,"context_line":"| **Do not use**                  | **Use**                            |"},{"line_number":39,"context_line":"+\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d+\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d+"},{"line_number":40,"context_line":"| After the software has been     | After you install the software,    |"},{"line_number":41,"context_line":"| installed, the computer can be  | start the computer.                |"}],"source_content_type":"text/x-rst","patch_set":7,"id":"ba15a1d1_7918ee75","line":38,"updated":"2015-09-22 14:22:21.000000000","message":"1) Can you switch the places of columns, so that correct usage goes first?\n\n2) I would prefer to change the columns\u0027 names to \"Correct\"/Incorrect examples or Good/Bad examples in all the patch.","commit_id":"ed9e093adb26ac0f1de36a051ab442b09fb6ca0f"},{"author":{"_account_id":14962,"name":"ologvinova","email":"ologvinova@mirantis.com","username":"ologvinova"},"change_message_id":"a60a89d52f44c920e2b7633805fcd105b776af92","unresolved":false,"context_lines":[{"line_number":35,"context_line":"**Example:**"},{"line_number":36,"context_line":""},{"line_number":37,"context_line":"+---------------------------------+------------------------------------+"},{"line_number":38,"context_line":"| **Do not use**                  | **Use**                            |"},{"line_number":39,"context_line":"+\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d+\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d+"},{"line_number":40,"context_line":"| After the software has been     | After you install the software,    |"},{"line_number":41,"context_line":"| installed, the computer can be  | start the computer.                |"}],"source_content_type":"text/x-rst","patch_set":7,"id":"ba15a1d1_a274e2fd","line":38,"in_reply_to":"ba15a1d1_08b5c82f","updated":"2015-09-23 09:05:56.000000000","message":"As I see from the section name, the purpose is to outline the guidelines, therefore, correct variant should go first.","commit_id":"ed9e093adb26ac0f1de36a051ab442b09fb6ca0f"},{"author":{"_account_id":17626,"name":"Svetlana Karslioglu","email":"skarslioglu@mirantis.com","username":"svekars"},"change_message_id":"239670e45f7853e89d8d8e8ee449340e9cc859df","unresolved":false,"context_lines":[{"line_number":35,"context_line":"**Example:**"},{"line_number":36,"context_line":""},{"line_number":37,"context_line":"+---------------------------------+------------------------------------+"},{"line_number":38,"context_line":"| **Do not use**                  | **Use**                            |"},{"line_number":39,"context_line":"+\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d+\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d+"},{"line_number":40,"context_line":"| After the software has been     | After you install the software,    |"},{"line_number":41,"context_line":"| installed, the computer can be  | start the computer.                |"}],"source_content_type":"text/x-rst","patch_set":7,"id":"ba15a1d1_08b5c82f","line":38,"in_reply_to":"ba15a1d1_7918ee75","updated":"2015-09-22 17:56:29.000000000","message":"I intentionally put the bad usage first, since we are trying to first say what not to do and then what to do. The purpose of this section is to outline the issues. Therefore, the \"do not use\" example should go first.","commit_id":"ed9e093adb26ac0f1de36a051ab442b09fb6ca0f"},{"author":{"_account_id":14962,"name":"ologvinova","email":"ologvinova@mirantis.com","username":"ologvinova"},"change_message_id":"1d95fe14c4307462f3070afac2a69acc0eaca2c2","unresolved":false,"context_lines":[{"line_number":56,"context_line":"+---------------------------------+------------------------------------+"},{"line_number":57,"context_line":"| **Do not use**                  | **Use**                            |"},{"line_number":58,"context_line":"+\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d+\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d+"},{"line_number":59,"context_line":"| Your actions resulted in error. | An error occurred.                 |"},{"line_number":60,"context_line":"+---------------------------------+------------------------------------+"},{"line_number":61,"context_line":""},{"line_number":62,"context_line":"* The agent of action is unknown, or you want to de-emphasize the agent of"}],"source_content_type":"text/x-rst","patch_set":7,"id":"ba15a1d1_47b42634","line":59,"updated":"2015-09-22 14:22:21.000000000","message":"Example of correct usage is not in passive here. Use the examples from wiki:\n\nIncorrect:\nIf the build fails, you probably omitted the flavor.\n\nCorrect:\nIf the build fails, the flavor might have been omitted.","commit_id":"ed9e093adb26ac0f1de36a051ab442b09fb6ca0f"},{"author":{"_account_id":17626,"name":"Svetlana Karslioglu","email":"skarslioglu@mirantis.com","username":"svekars"},"change_message_id":"239670e45f7853e89d8d8e8ee449340e9cc859df","unresolved":false,"context_lines":[{"line_number":56,"context_line":"+---------------------------------+------------------------------------+"},{"line_number":57,"context_line":"| **Do not use**                  | **Use**                            |"},{"line_number":58,"context_line":"+\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d+\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d+"},{"line_number":59,"context_line":"| Your actions resulted in error. | An error occurred.                 |"},{"line_number":60,"context_line":"+---------------------------------+------------------------------------+"},{"line_number":61,"context_line":""},{"line_number":62,"context_line":"* The agent of action is unknown, or you want to de-emphasize the agent of"}],"source_content_type":"text/x-rst","patch_set":7,"id":"ba15a1d1_ce2fd99f","line":59,"in_reply_to":"ba15a1d1_47b42634","updated":"2015-09-22 17:56:29.000000000","message":"Done","commit_id":"ed9e093adb26ac0f1de36a051ab442b09fb6ca0f"},{"author":{"_account_id":14962,"name":"ologvinova","email":"ologvinova@mirantis.com","username":"ologvinova"},"change_message_id":"1d95fe14c4307462f3070afac2a69acc0eaca2c2","unresolved":false,"context_lines":[{"line_number":66,"context_line":"| **Do not use**                  | **Use**                            |"},{"line_number":67,"context_line":"+\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d+\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d+"},{"line_number":68,"context_line":"| Something caused multiple errors| Multiple errors occurred during the|"},{"line_number":69,"context_line":"| during the installation.        | installation.                      |"},{"line_number":70,"context_line":"+---------------------------------+------------------------------------+"},{"line_number":71,"context_line":""},{"line_number":72,"context_line":"* Recasting the sentence in active voice is wordy or awkward."}],"source_content_type":"text/x-rst","patch_set":7,"id":"ba15a1d1_a7b5027f","line":69,"updated":"2015-09-22 14:22:21.000000000","message":"again, no passive in the **Use** column. Change to smth like:\n\nIncorrect:\nThe product, OS, or database returns the messages.\n\nCorrect:\nThe messages are returned [by the database].","commit_id":"ed9e093adb26ac0f1de36a051ab442b09fb6ca0f"},{"author":{"_account_id":17626,"name":"Svetlana Karslioglu","email":"skarslioglu@mirantis.com","username":"svekars"},"change_message_id":"239670e45f7853e89d8d8e8ee449340e9cc859df","unresolved":false,"context_lines":[{"line_number":66,"context_line":"| **Do not use**                  | **Use**                            |"},{"line_number":67,"context_line":"+\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d+\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d+"},{"line_number":68,"context_line":"| Something caused multiple errors| Multiple errors occurred during the|"},{"line_number":69,"context_line":"| during the installation.        | installation.                      |"},{"line_number":70,"context_line":"+---------------------------------+------------------------------------+"},{"line_number":71,"context_line":""},{"line_number":72,"context_line":"* Recasting the sentence in active voice is wordy or awkward."}],"source_content_type":"text/x-rst","patch_set":7,"id":"ba15a1d1_2d5f7e42","line":69,"in_reply_to":"ba15a1d1_a7b5027f","updated":"2015-09-22 17:56:29.000000000","message":"This example is not relevant to the use case.","commit_id":"ed9e093adb26ac0f1de36a051ab442b09fb6ca0f"},{"author":{"_account_id":14962,"name":"ologvinova","email":"ologvinova@mirantis.com","username":"ologvinova"},"change_message_id":"1d95fe14c4307462f3070afac2a69acc0eaca2c2","unresolved":false,"context_lines":[{"line_number":141,"context_line":"| **Do not use**                    | **Use**                            |"},{"line_number":142,"context_line":"+\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d+\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d+"},{"line_number":143,"context_line":"| To create a server, you specify a | To create a server, specify a name,|"},{"line_number":144,"context_line":"| name, flavor, and image.          | flavor, and image. (imperative     |"},{"line_number":145,"context_line":"|                                   | mood).                             |"},{"line_number":146,"context_line":"+-----------------------------------+------------------------------------+"},{"line_number":147,"context_line":""}],"source_content_type":"text/x-rst","patch_set":7,"id":"ba15a1d1_79b9ce14","line":144,"updated":"2015-09-22 14:22:21.000000000","message":"These 2 examples should go to the *Use* column as 1 context.\n\n*Do not use* column example:\n\nCreating a server involves specifying a name, flavor, and image.\nTo create a server, the user specifies and name, flavor, and image.","commit_id":"ed9e093adb26ac0f1de36a051ab442b09fb6ca0f"},{"author":{"_account_id":14962,"name":"ologvinova","email":"ologvinova@mirantis.com","username":"ologvinova"},"change_message_id":"a60a89d52f44c920e2b7633805fcd105b776af92","unresolved":false,"context_lines":[{"line_number":141,"context_line":"| **Do not use**                    | **Use**                            |"},{"line_number":142,"context_line":"+\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d+\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d+"},{"line_number":143,"context_line":"| To create a server, you specify a | To create a server, specify a name,|"},{"line_number":144,"context_line":"| name, flavor, and image.          | flavor, and image. (imperative     |"},{"line_number":145,"context_line":"|                                   | mood).                             |"},{"line_number":146,"context_line":"+-----------------------------------+------------------------------------+"},{"line_number":147,"context_line":""}],"source_content_type":"text/x-rst","patch_set":7,"id":"ba15a1d1_d2b8c113","line":144,"in_reply_to":"ba15a1d1_48c0a07c","updated":"2015-09-23 09:05:56.000000000","message":"Check again wiki: https://wiki.openstack.org/wiki/Documentation/Conventions#Write_to_you_.28the_user.29 - there are examples of correct and incorrect usage. And you put correct sentence to the \"Do not use\" column","commit_id":"ed9e093adb26ac0f1de36a051ab442b09fb6ca0f"},{"author":{"_account_id":17626,"name":"Svetlana Karslioglu","email":"skarslioglu@mirantis.com","username":"svekars"},"change_message_id":"239670e45f7853e89d8d8e8ee449340e9cc859df","unresolved":false,"context_lines":[{"line_number":141,"context_line":"| **Do not use**                    | **Use**                            |"},{"line_number":142,"context_line":"+\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d+\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d+"},{"line_number":143,"context_line":"| To create a server, you specify a | To create a server, specify a name,|"},{"line_number":144,"context_line":"| name, flavor, and image.          | flavor, and image. (imperative     |"},{"line_number":145,"context_line":"|                                   | mood).                             |"},{"line_number":146,"context_line":"+-----------------------------------+------------------------------------+"},{"line_number":147,"context_line":""}],"source_content_type":"text/x-rst","patch_set":7,"id":"ba15a1d1_48c0a07c","line":144,"in_reply_to":"ba15a1d1_79b9ce14","updated":"2015-09-22 17:56:29.000000000","message":"These examples are from the original wiki page. I think we should keep them as is.","commit_id":"ed9e093adb26ac0f1de36a051ab442b09fb6ca0f"},{"author":{"_account_id":14962,"name":"ologvinova","email":"ologvinova@mirantis.com","username":"ologvinova"},"change_message_id":"1d95fe14c4307462f3070afac2a69acc0eaca2c2","unresolved":false,"context_lines":[{"line_number":232,"context_line":"+------------------------+----------------------------------+"},{"line_number":233,"context_line":"| fatal                  | serious                          |"},{"line_number":234,"context_line":"+------------------------+----------------------------------+"},{"line_number":235,"context_line":"| error                  | problem                          |"},{"line_number":236,"context_line":"+------------------------+----------------------------------+"},{"line_number":237,"context_line":"| destroy                | remove                           |"},{"line_number":238,"context_line":"+------------------------+----------------------------------+"}],"source_content_type":"text/x-rst","patch_set":7,"id":"ba15a1d1_bfb65fda","line":235,"updated":"2015-09-22 14:22:21.000000000","message":"I still do not think that \u0027error\u0027 can be replaced by problem in any context (error message, for ex.), so I would remove this example at all.","commit_id":"ed9e093adb26ac0f1de36a051ab442b09fb6ca0f"},{"author":{"_account_id":14962,"name":"ologvinova","email":"ologvinova@mirantis.com","username":"ologvinova"},"change_message_id":"a60a89d52f44c920e2b7633805fcd105b776af92","unresolved":false,"context_lines":[{"line_number":232,"context_line":"+------------------------+----------------------------------+"},{"line_number":233,"context_line":"| fatal                  | serious                          |"},{"line_number":234,"context_line":"+------------------------+----------------------------------+"},{"line_number":235,"context_line":"| error                  | problem                          |"},{"line_number":236,"context_line":"+------------------------+----------------------------------+"},{"line_number":237,"context_line":"| destroy                | remove                           |"},{"line_number":238,"context_line":"+------------------------+----------------------------------+"}],"source_content_type":"text/x-rst","patch_set":7,"id":"ba15a1d1_5dd4c71e","line":235,"in_reply_to":"ba15a1d1_aef1456c","updated":"2015-09-23 09:05:56.000000000","message":"These are not recommendations, these are guidelines. My main point is that these 2 words are not synonyms.","commit_id":"ed9e093adb26ac0f1de36a051ab442b09fb6ca0f"},{"author":{"_account_id":17626,"name":"Svetlana Karslioglu","email":"skarslioglu@mirantis.com","username":"svekars"},"change_message_id":"239670e45f7853e89d8d8e8ee449340e9cc859df","unresolved":false,"context_lines":[{"line_number":232,"context_line":"+------------------------+----------------------------------+"},{"line_number":233,"context_line":"| fatal                  | serious                          |"},{"line_number":234,"context_line":"+------------------------+----------------------------------+"},{"line_number":235,"context_line":"| error                  | problem                          |"},{"line_number":236,"context_line":"+------------------------+----------------------------------+"},{"line_number":237,"context_line":"| destroy                | remove                           |"},{"line_number":238,"context_line":"+------------------------+----------------------------------+"}],"source_content_type":"text/x-rst","patch_set":7,"id":"ba15a1d1_aef1456c","line":235,"in_reply_to":"ba15a1d1_bfb65fda","updated":"2015-09-22 17:56:29.000000000","message":"do not use error as a modifier. Just say \"message\" \nExample: \nYou may get the following message: ERROR....\nAnyways, these are recommendations. You think that you should absolutely use it, then use it.","commit_id":"ed9e093adb26ac0f1de36a051ab442b09fb6ca0f"},{"author":{"_account_id":14962,"name":"ologvinova","email":"ologvinova@mirantis.com","username":"ologvinova"},"change_message_id":"1d95fe14c4307462f3070afac2a69acc0eaca2c2","unresolved":false,"context_lines":[{"line_number":261,"context_line":"+-------------------------+------------------------+"},{"line_number":262,"context_line":"| **Ambiguous**           | **Better**             |"},{"line_number":263,"context_line":"+\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d+\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d+"},{"line_number":264,"context_line":"| written up              | compose                |"},{"line_number":265,"context_line":"+-------------------------+------------------------+"},{"line_number":266,"context_line":"| pop up                  | appear                 |"},{"line_number":267,"context_line":"+-------------------------+------------------------+"}],"source_content_type":"text/x-rst","patch_set":7,"id":"ba15a1d1_5ffe2339","line":264,"updated":"2015-09-22 14:22:21.000000000","message":"compose -\u003e composed (for consistency in part of speech with \u0027written up\u0027)","commit_id":"ed9e093adb26ac0f1de36a051ab442b09fb6ca0f"},{"author":{"_account_id":17626,"name":"Svetlana Karslioglu","email":"skarslioglu@mirantis.com","username":"svekars"},"change_message_id":"239670e45f7853e89d8d8e8ee449340e9cc859df","unresolved":false,"context_lines":[{"line_number":261,"context_line":"+-------------------------+------------------------+"},{"line_number":262,"context_line":"| **Ambiguous**           | **Better**             |"},{"line_number":263,"context_line":"+\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d+\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d+"},{"line_number":264,"context_line":"| written up              | compose                |"},{"line_number":265,"context_line":"+-------------------------+------------------------+"},{"line_number":266,"context_line":"| pop up                  | appear                 |"},{"line_number":267,"context_line":"+-------------------------+------------------------+"}],"source_content_type":"text/x-rst","patch_set":7,"id":"ba15a1d1_283becd2","line":264,"in_reply_to":"ba15a1d1_5ffe2339","updated":"2015-09-22 17:56:29.000000000","message":"Done","commit_id":"ed9e093adb26ac0f1de36a051ab442b09fb6ca0f"},{"author":{"_account_id":14962,"name":"ologvinova","email":"ologvinova@mirantis.com","username":"ologvinova"},"change_message_id":"1d95fe14c4307462f3070afac2a69acc0eaca2c2","unresolved":false,"context_lines":[{"line_number":280,"context_line":"+\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d+\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d+"},{"line_number":281,"context_line":"| The monitoring system   | The monitoring system performs|"},{"line_number":282,"context_line":"| should perform regular  | regular checks to ensure the  |"},{"line_number":283,"context_line":"| checks to verify that   | Ceph cluster is functioning   |"},{"line_number":284,"context_line":"| the Ceph cluster is     | correctly. Use the            |"},{"line_number":285,"context_line":"| healthy. This can be    | ``ceph health`` command to run|"},{"line_number":286,"context_line":"| achieved using the      | a health check.               |"}],"source_content_type":"text/x-rst","patch_set":7,"id":"ba15a1d1_90f3480a","line":283,"updated":"2015-09-22 14:22:21.000000000","message":"\u0027that\u0027 here is a subordinating conjunction and not a pronoun here. So it\u0027s not an appropriate example for the pronouns\u0027 topic. \n\nLeave the last sentence only, maybe rephrasing it a bit -\u003e This can be achieved using the Ceph health command that shows whether Ceph cluster is healthy.","commit_id":"ed9e093adb26ac0f1de36a051ab442b09fb6ca0f"},{"author":{"_account_id":14962,"name":"ologvinova","email":"ologvinova@mirantis.com","username":"ologvinova"},"change_message_id":"7c80eff57fc40cee44a5280bd17393cbd8c4c9bc","unresolved":false,"context_lines":[{"line_number":71,"context_line":"| **Do not use**                  | **Use**                            |"},{"line_number":72,"context_line":"+\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d+\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d+"},{"line_number":73,"context_line":"| Something caused multiple errors| Multiple errors occurred during the|"},{"line_number":74,"context_line":"| during the installation.        | installation.                      |"},{"line_number":75,"context_line":"+---------------------------------+------------------------------------+"},{"line_number":76,"context_line":""},{"line_number":77,"context_line":"* Recasting the sentence in active voice is wordy or awkward."}],"source_content_type":"text/x-rst","patch_set":10,"id":"ba15a1d1_3da7930c","line":74,"updated":"2015-09-23 09:09:08.000000000","message":"The **Use** example is not relevant to the use case as it doesn\u0027t contain passive.","commit_id":"b35753b2dcd4e99224ba2377b72ca28ab1517a81"},{"author":{"_account_id":17626,"name":"Svetlana Karslioglu","email":"skarslioglu@mirantis.com","username":"svekars"},"change_message_id":"0cb468014b75dff8403583ea9499707448e568a1","unresolved":false,"context_lines":[{"line_number":71,"context_line":"| **Do not use**                  | **Use**                            |"},{"line_number":72,"context_line":"+\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d+\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d+"},{"line_number":73,"context_line":"| Something caused multiple errors| Multiple errors occurred during the|"},{"line_number":74,"context_line":"| during the installation.        | installation.                      |"},{"line_number":75,"context_line":"+---------------------------------+------------------------------------+"},{"line_number":76,"context_line":""},{"line_number":77,"context_line":"* Recasting the sentence in active voice is wordy or awkward."}],"source_content_type":"text/x-rst","patch_set":10,"id":"ba15a1d1_165a86f2","line":74,"in_reply_to":"ba15a1d1_3da7930c","updated":"2015-09-23 23:09:30.000000000","message":"Done","commit_id":"b35753b2dcd4e99224ba2377b72ca28ab1517a81"},{"author":{"_account_id":14396,"name":"Alexander Adamov","email":"aadamov@mirantis.com","username":"Alexander"},"change_message_id":"31748a3cd86dc5992d61f3483daf3379eec9ae73","unresolved":false,"context_lines":[{"line_number":91,"context_line":""},{"line_number":92,"context_line":"Users read documentation to perform tasks or gather information. For users,"},{"line_number":93,"context_line":"these activities take place in their present, so the present tense is"},{"line_number":94,"context_line":"appropriate in most cases. Additionally, present tense is easier to read"},{"line_number":95,"context_line":"than past or future tense."},{"line_number":96,"context_line":""},{"line_number":97,"context_line":"Use future tense only when you need to emphasize that something will occur"}],"source_content_type":"text/x-rst","patch_set":10,"id":"ba15a1d1_45114d03","line":94,"updated":"2015-09-23 09:33:22.000000000","message":"the present tense","commit_id":"b35753b2dcd4e99224ba2377b72ca28ab1517a81"},{"author":{"_account_id":17626,"name":"Svetlana Karslioglu","email":"skarslioglu@mirantis.com","username":"svekars"},"change_message_id":"0cb468014b75dff8403583ea9499707448e568a1","unresolved":false,"context_lines":[{"line_number":91,"context_line":""},{"line_number":92,"context_line":"Users read documentation to perform tasks or gather information. For users,"},{"line_number":93,"context_line":"these activities take place in their present, so the present tense is"},{"line_number":94,"context_line":"appropriate in most cases. Additionally, present tense is easier to read"},{"line_number":95,"context_line":"than past or future tense."},{"line_number":96,"context_line":""},{"line_number":97,"context_line":"Use future tense only when you need to emphasize that something will occur"}],"source_content_type":"text/x-rst","patch_set":10,"id":"ba15a1d1_157effae","line":94,"in_reply_to":"ba15a1d1_45114d03","updated":"2015-09-23 23:09:30.000000000","message":"Done","commit_id":"b35753b2dcd4e99224ba2377b72ca28ab1517a81"},{"author":{"_account_id":14396,"name":"Alexander Adamov","email":"aadamov@mirantis.com","username":"Alexander"},"change_message_id":"31748a3cd86dc5992d61f3483daf3379eec9ae73","unresolved":false,"context_lines":[{"line_number":92,"context_line":"Users read documentation to perform tasks or gather information. For users,"},{"line_number":93,"context_line":"these activities take place in their present, so the present tense is"},{"line_number":94,"context_line":"appropriate in most cases. Additionally, present tense is easier to read"},{"line_number":95,"context_line":"than past or future tense."},{"line_number":96,"context_line":""},{"line_number":97,"context_line":"Use future tense only when you need to emphasize that something will occur"},{"line_number":98,"context_line":"later (from the users\u0027 perspective)."}],"source_content_type":"text/x-rst","patch_set":10,"id":"ba15a1d1_c5fd5db2","line":95,"updated":"2015-09-23 09:33:22.000000000","message":"the past or future tense","commit_id":"b35753b2dcd4e99224ba2377b72ca28ab1517a81"},{"author":{"_account_id":17626,"name":"Svetlana Karslioglu","email":"skarslioglu@mirantis.com","username":"svekars"},"change_message_id":"0cb468014b75dff8403583ea9499707448e568a1","unresolved":false,"context_lines":[{"line_number":92,"context_line":"Users read documentation to perform tasks or gather information. For users,"},{"line_number":93,"context_line":"these activities take place in their present, so the present tense is"},{"line_number":94,"context_line":"appropriate in most cases. Additionally, present tense is easier to read"},{"line_number":95,"context_line":"than past or future tense."},{"line_number":96,"context_line":""},{"line_number":97,"context_line":"Use future tense only when you need to emphasize that something will occur"},{"line_number":98,"context_line":"later (from the users\u0027 perspective)."}],"source_content_type":"text/x-rst","patch_set":10,"id":"ba15a1d1_357b03c0","line":95,"in_reply_to":"ba15a1d1_c5fd5db2","updated":"2015-09-23 23:09:30.000000000","message":"Done","commit_id":"b35753b2dcd4e99224ba2377b72ca28ab1517a81"},{"author":{"_account_id":14962,"name":"ologvinova","email":"ologvinova@mirantis.com","username":"ologvinova"},"change_message_id":"7c80eff57fc40cee44a5280bd17393cbd8c4c9bc","unresolved":false,"context_lines":[{"line_number":95,"context_line":"than past or future tense."},{"line_number":96,"context_line":""},{"line_number":97,"context_line":"Use future tense only when you need to emphasize that something will occur"},{"line_number":98,"context_line":"later (from the users\u0027 perspective)."},{"line_number":99,"context_line":""},{"line_number":100,"context_line":"Write in second person"},{"line_number":101,"context_line":"----------------------"}],"source_content_type":"text/x-rst","patch_set":10,"id":"ba15a1d1_3d7eb36a","line":98,"updated":"2015-09-23 09:09:08.000000000","message":"Provide example (see patch 7).","commit_id":"b35753b2dcd4e99224ba2377b72ca28ab1517a81"},{"author":{"_account_id":17626,"name":"Svetlana Karslioglu","email":"skarslioglu@mirantis.com","username":"svekars"},"change_message_id":"0cb468014b75dff8403583ea9499707448e568a1","unresolved":false,"context_lines":[{"line_number":95,"context_line":"than past or future tense."},{"line_number":96,"context_line":""},{"line_number":97,"context_line":"Use future tense only when you need to emphasize that something will occur"},{"line_number":98,"context_line":"later (from the users\u0027 perspective)."},{"line_number":99,"context_line":""},{"line_number":100,"context_line":"Write in second person"},{"line_number":101,"context_line":"----------------------"}],"source_content_type":"text/x-rst","patch_set":10,"id":"ba15a1d1_f654b2c6","line":98,"in_reply_to":"ba15a1d1_3d7eb36a","updated":"2015-09-23 23:09:30.000000000","message":"Done","commit_id":"b35753b2dcd4e99224ba2377b72ca28ab1517a81"},{"author":{"_account_id":14396,"name":"Alexander Adamov","email":"aadamov@mirantis.com","username":"Alexander"},"change_message_id":"31748a3cd86dc5992d61f3483daf3379eec9ae73","unresolved":false,"context_lines":[{"line_number":124,"context_line":""},{"line_number":125,"context_line":"Do not use first person to avoid naming the product or to avoid using passive"},{"line_number":126,"context_line":"voice. If the product is performing the action, use third person (the product"},{"line_number":127,"context_line":"as actor). If you want to de-emphasize the agent of action and emphasize the"},{"line_number":128,"context_line":"object on which the action is performed, use passive voice."},{"line_number":129,"context_line":""},{"line_number":130,"context_line":"The first-person singular pronoun `I` is acceptable in the question part of"}],"source_content_type":"text/x-rst","patch_set":10,"id":"ba15a1d1_a59ce96a","line":127,"updated":"2015-09-23 09:33:22.000000000","message":"as an actor","commit_id":"b35753b2dcd4e99224ba2377b72ca28ab1517a81"},{"author":{"_account_id":17626,"name":"Svetlana Karslioglu","email":"skarslioglu@mirantis.com","username":"svekars"},"change_message_id":"0cb468014b75dff8403583ea9499707448e568a1","unresolved":false,"context_lines":[{"line_number":124,"context_line":""},{"line_number":125,"context_line":"Do not use first person to avoid naming the product or to avoid using passive"},{"line_number":126,"context_line":"voice. If the product is performing the action, use third person (the product"},{"line_number":127,"context_line":"as actor). If you want to de-emphasize the agent of action and emphasize the"},{"line_number":128,"context_line":"object on which the action is performed, use passive voice."},{"line_number":129,"context_line":""},{"line_number":130,"context_line":"The first-person singular pronoun `I` is acceptable in the question part of"}],"source_content_type":"text/x-rst","patch_set":10,"id":"ba15a1d1_56647eb7","line":127,"in_reply_to":"ba15a1d1_a59ce96a","updated":"2015-09-23 23:09:30.000000000","message":"Done","commit_id":"b35753b2dcd4e99224ba2377b72ca28ab1517a81"},{"author":{"_account_id":14962,"name":"ologvinova","email":"ologvinova@mirantis.com","username":"ologvinova"},"change_message_id":"7c80eff57fc40cee44a5280bd17393cbd8c4c9bc","unresolved":false,"context_lines":[{"line_number":139,"context_line":"| **Do not use**                    | **Use**                            |"},{"line_number":140,"context_line":"+\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d+\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d+"},{"line_number":141,"context_line":"| To create a server, you specify a | To create a server, specify a name,|"},{"line_number":142,"context_line":"| name, flavor, and image.          | flavor, and image. (imperative     |"},{"line_number":143,"context_line":"|                                   | mood).                             |"},{"line_number":144,"context_line":"+-----------------------------------+------------------------------------+"},{"line_number":145,"context_line":""}],"source_content_type":"text/x-rst","patch_set":10,"id":"ba15a1d1_d24f6132","line":142,"updated":"2015-09-23 09:09:08.000000000","message":"Check patch 7 and change accordingly.","commit_id":"b35753b2dcd4e99224ba2377b72ca28ab1517a81"},{"author":{"_account_id":14947,"name":"Maria Zlatkova","email":"mzlatkova@mirantis.com","username":"mzlatkova"},"change_message_id":"c156e03a4bd91698e1b6a9dc1f6784e04a08500b","unresolved":false,"context_lines":[{"line_number":139,"context_line":"| **Do not use**                    | **Use**                            |"},{"line_number":140,"context_line":"+\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d+\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d+"},{"line_number":141,"context_line":"| To create a server, you specify a | To create a server, specify a name,|"},{"line_number":142,"context_line":"| name, flavor, and image.          | flavor, and image. (imperative     |"},{"line_number":143,"context_line":"|                                   | mood).                             |"},{"line_number":144,"context_line":"+-----------------------------------+------------------------------------+"},{"line_number":145,"context_line":""}],"source_content_type":"text/x-rst","patch_set":10,"id":"ba15a1d1_e573c17e","line":142,"in_reply_to":"ba15a1d1_d24f6132","updated":"2015-09-23 09:42:10.000000000","message":"+1","commit_id":"b35753b2dcd4e99224ba2377b72ca28ab1517a81"},{"author":{"_account_id":17626,"name":"Svetlana Karslioglu","email":"skarslioglu@mirantis.com","username":"svekars"},"change_message_id":"0cb468014b75dff8403583ea9499707448e568a1","unresolved":false,"context_lines":[{"line_number":139,"context_line":"| **Do not use**                    | **Use**                            |"},{"line_number":140,"context_line":"+\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d+\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d+"},{"line_number":141,"context_line":"| To create a server, you specify a | To create a server, specify a name,|"},{"line_number":142,"context_line":"| name, flavor, and image.          | flavor, and image. (imperative     |"},{"line_number":143,"context_line":"|                                   | mood).                             |"},{"line_number":144,"context_line":"+-----------------------------------+------------------------------------+"},{"line_number":145,"context_line":""}],"source_content_type":"text/x-rst","patch_set":10,"id":"ba15a1d1_365f8ae6","line":142,"in_reply_to":"ba15a1d1_e573c17e","updated":"2015-09-23 23:09:30.000000000","message":"Done","commit_id":"b35753b2dcd4e99224ba2377b72ca28ab1517a81"},{"author":{"_account_id":14947,"name":"Maria Zlatkova","email":"mzlatkova@mirantis.com","username":"mzlatkova"},"change_message_id":"c156e03a4bd91698e1b6a9dc1f6784e04a08500b","unresolved":false,"context_lines":[{"line_number":172,"context_line":""},{"line_number":173,"context_line":""},{"line_number":174,"context_line":"Keep sentences short"},{"line_number":175,"context_line":"--------------------"},{"line_number":176,"context_line":""},{"line_number":177,"context_line":"Short and simple sentences are easier to read and understand."},{"line_number":178,"context_line":""}],"source_content_type":"text/x-rst","patch_set":10,"id":"ba15a1d1_326a5dee","line":175,"updated":"2015-09-23 09:42:10.000000000","message":"Since we follow the principles of minimalism, I suggest combining this section with the one below (line 179).","commit_id":"b35753b2dcd4e99224ba2377b72ca28ab1517a81"},{"author":{"_account_id":17626,"name":"Svetlana Karslioglu","email":"skarslioglu@mirantis.com","username":"svekars"},"change_message_id":"0cb468014b75dff8403583ea9499707448e568a1","unresolved":false,"context_lines":[{"line_number":172,"context_line":""},{"line_number":173,"context_line":""},{"line_number":174,"context_line":"Keep sentences short"},{"line_number":175,"context_line":"--------------------"},{"line_number":176,"context_line":""},{"line_number":177,"context_line":"Short and simple sentences are easier to read and understand."},{"line_number":178,"context_line":""}],"source_content_type":"text/x-rst","patch_set":10,"id":"ba15a1d1_36054a79","line":175,"in_reply_to":"ba15a1d1_326a5dee","updated":"2015-09-23 23:09:30.000000000","message":"Done","commit_id":"b35753b2dcd4e99224ba2377b72ca28ab1517a81"},{"author":{"_account_id":14396,"name":"Alexander Adamov","email":"aadamov@mirantis.com","username":"Alexander"},"change_message_id":"31748a3cd86dc5992d61f3483daf3379eec9ae73","unresolved":false,"context_lines":[{"line_number":191,"context_line":"Describe the most common use case first"},{"line_number":192,"context_line":"---------------------------------------"},{"line_number":193,"context_line":""},{"line_number":194,"context_line":"Put the most common case in the main clause and in the beginning of a"},{"line_number":195,"context_line":"paragraph or section. You can introduce additional"},{"line_number":196,"context_line":"use cases by starting a sentence with `however` or `if`."},{"line_number":197,"context_line":""}],"source_content_type":"text/x-rst","patch_set":10,"id":"ba15a1d1_45b2ade6","line":194,"updated":"2015-09-23 09:33:22.000000000","message":"at the beginning","commit_id":"b35753b2dcd4e99224ba2377b72ca28ab1517a81"},{"author":{"_account_id":17626,"name":"Svetlana Karslioglu","email":"skarslioglu@mirantis.com","username":"svekars"},"change_message_id":"0cb468014b75dff8403583ea9499707448e568a1","unresolved":false,"context_lines":[{"line_number":191,"context_line":"Describe the most common use case first"},{"line_number":192,"context_line":"---------------------------------------"},{"line_number":193,"context_line":""},{"line_number":194,"context_line":"Put the most common case in the main clause and in the beginning of a"},{"line_number":195,"context_line":"paragraph or section. You can introduce additional"},{"line_number":196,"context_line":"use cases by starting a sentence with `however` or `if`."},{"line_number":197,"context_line":""}],"source_content_type":"text/x-rst","patch_set":10,"id":"ba15a1d1_560a3e8b","line":194,"in_reply_to":"ba15a1d1_45b2ade6","updated":"2015-09-23 23:09:30.000000000","message":"Done","commit_id":"b35753b2dcd4e99224ba2377b72ca28ab1517a81"},{"author":{"_account_id":14962,"name":"ologvinova","email":"ologvinova@mirantis.com","username":"ologvinova"},"change_message_id":"7c80eff57fc40cee44a5280bd17393cbd8c4c9bc","unresolved":false,"context_lines":[{"line_number":215,"context_line":"Write in positive tone. Positive sentences improve readability."},{"line_number":216,"context_line":"Try to avoid the following words as much as possible:"},{"line_number":217,"context_line":""},{"line_number":218,"context_line":"**Example of usage**"},{"line_number":219,"context_line":""},{"line_number":220,"context_line":"+------------------------+----------------------------------+"},{"line_number":221,"context_line":"| **Do not use**         | **Use**                          |"}],"source_content_type":"text/x-rst","patch_set":10,"id":"ba15a1d1_1df08ffc","line":218,"updated":"2015-09-23 09:09:08.000000000","message":"There are several examples in the table, so change \u0027Example\u0027 to \u0027Examples\u0027.","commit_id":"b35753b2dcd4e99224ba2377b72ca28ab1517a81"},{"author":{"_account_id":17626,"name":"Svetlana Karslioglu","email":"skarslioglu@mirantis.com","username":"svekars"},"change_message_id":"0cb468014b75dff8403583ea9499707448e568a1","unresolved":false,"context_lines":[{"line_number":215,"context_line":"Write in positive tone. Positive sentences improve readability."},{"line_number":216,"context_line":"Try to avoid the following words as much as possible:"},{"line_number":217,"context_line":""},{"line_number":218,"context_line":"**Example of usage**"},{"line_number":219,"context_line":""},{"line_number":220,"context_line":"+------------------------+----------------------------------+"},{"line_number":221,"context_line":"| **Do not use**         | **Use**                          |"}],"source_content_type":"text/x-rst","patch_set":10,"id":"ba15a1d1_d6cf2e54","line":218,"in_reply_to":"ba15a1d1_1df08ffc","updated":"2015-09-23 23:09:30.000000000","message":"We have multiple examples in many tables, similarly to the wiki page:\nhttps://wiki.openstack.org/wiki/Documentation/Conventions#Write_to_you_.28the_user.29\n\nHowever, for consistency we should use the same table title.","commit_id":"b35753b2dcd4e99224ba2377b72ca28ab1517a81"},{"author":{"_account_id":14962,"name":"ologvinova","email":"ologvinova@mirantis.com","username":"ologvinova"},"change_message_id":"7c80eff57fc40cee44a5280bd17393cbd8c4c9bc","unresolved":false,"context_lines":[{"line_number":232,"context_line":"+------------------------+----------------------------------+"},{"line_number":233,"context_line":"| fatal                  | serious                          |"},{"line_number":234,"context_line":"+------------------------+----------------------------------+"},{"line_number":235,"context_line":"| error                  | problem                          |"},{"line_number":236,"context_line":"+------------------------+----------------------------------+"},{"line_number":237,"context_line":"| destroy                | remove                           |"},{"line_number":238,"context_line":"+------------------------+----------------------------------+"}],"source_content_type":"text/x-rst","patch_set":10,"id":"ba15a1d1_dd4c5744","line":235,"updated":"2015-09-23 09:09:08.000000000","message":"Remove this example, as error/problem are not synonyms.","commit_id":"b35753b2dcd4e99224ba2377b72ca28ab1517a81"},{"author":{"_account_id":17626,"name":"Svetlana Karslioglu","email":"skarslioglu@mirantis.com","username":"svekars"},"change_message_id":"0cb468014b75dff8403583ea9499707448e568a1","unresolved":false,"context_lines":[{"line_number":232,"context_line":"+------------------------+----------------------------------+"},{"line_number":233,"context_line":"| fatal                  | serious                          |"},{"line_number":234,"context_line":"+------------------------+----------------------------------+"},{"line_number":235,"context_line":"| error                  | problem                          |"},{"line_number":236,"context_line":"+------------------------+----------------------------------+"},{"line_number":237,"context_line":"| destroy                | remove                           |"},{"line_number":238,"context_line":"+------------------------+----------------------------------+"}],"source_content_type":"text/x-rst","patch_set":10,"id":"ba15a1d1_76d8a21e","line":235,"in_reply_to":"ba15a1d1_dd4c5744","updated":"2015-09-23 23:09:30.000000000","message":"Done","commit_id":"b35753b2dcd4e99224ba2377b72ca28ab1517a81"},{"author":{"_account_id":14962,"name":"ologvinova","email":"ologvinova@mirantis.com","username":"ologvinova"},"change_message_id":"7c80eff57fc40cee44a5280bd17393cbd8c4c9bc","unresolved":false,"context_lines":[{"line_number":283,"context_line":"| The monitoring system   | The monitoring system performs|"},{"line_number":284,"context_line":"| should perform regular  | regular checks to ensure the  |"},{"line_number":285,"context_line":"| checks to verify that   | Ceph cluster is functioning   |"},{"line_number":286,"context_line":"| the Ceph cluster is     | correctly. Use the            |"},{"line_number":287,"context_line":"| healthy. This can be    | ``ceph health`` command to run|"},{"line_number":288,"context_line":"| achieved using the      | a health check.               |"},{"line_number":289,"context_line":"| Ceph health command.    |                               |"}],"source_content_type":"text/x-rst","patch_set":10,"id":"ba15a1d1_f221454e","line":286,"updated":"2015-09-23 09:09:08.000000000","message":"Modify the example according to my comment in the patch 7.","commit_id":"b35753b2dcd4e99224ba2377b72ca28ab1517a81"},{"author":{"_account_id":17626,"name":"Svetlana Karslioglu","email":"skarslioglu@mirantis.com","username":"svekars"},"change_message_id":"0cb468014b75dff8403583ea9499707448e568a1","unresolved":false,"context_lines":[{"line_number":283,"context_line":"| The monitoring system   | The monitoring system performs|"},{"line_number":284,"context_line":"| should perform regular  | regular checks to ensure the  |"},{"line_number":285,"context_line":"| checks to verify that   | Ceph cluster is functioning   |"},{"line_number":286,"context_line":"| the Ceph cluster is     | correctly. Use the            |"},{"line_number":287,"context_line":"| healthy. This can be    | ``ceph health`` command to run|"},{"line_number":288,"context_line":"| achieved using the      | a health check.               |"},{"line_number":289,"context_line":"| Ceph health command.    |                               |"}],"source_content_type":"text/x-rst","patch_set":10,"id":"ba15a1d1_761d02bd","line":286,"in_reply_to":"ba15a1d1_f221454e","updated":"2015-09-23 23:09:30.000000000","message":"The way you propose to change the example really does not make it more descriptive.","commit_id":"b35753b2dcd4e99224ba2377b72ca28ab1517a81"},{"author":{"_account_id":14947,"name":"Maria Zlatkova","email":"mzlatkova@mirantis.com","username":"mzlatkova"},"change_message_id":"c156e03a4bd91698e1b6a9dc1f6784e04a08500b","unresolved":false,"context_lines":[{"line_number":310,"context_line":"---------------------"},{"line_number":311,"context_line":""},{"line_number":312,"context_line":"Do not express your fears or feelings in technical writing by avoiding"},{"line_number":313,"context_line":"the adverbs such as `probably`, `hopefully`, `basically`, and so on."},{"line_number":314,"context_line":""},{"line_number":315,"context_line":"Do not use contractions"},{"line_number":316,"context_line":"-----------------------"}],"source_content_type":"text/x-rst","patch_set":10,"id":"ba15a1d1_125dd946","line":313,"updated":"2015-09-23 09:42:10.000000000","message":"I would split the sentence into two shorter ones: Do not express your fears or feelings in technical writing. Avoid the adverbs such as `probably`, `hopefully`, `basically`, and so on.","commit_id":"b35753b2dcd4e99224ba2377b72ca28ab1517a81"},{"author":{"_account_id":17626,"name":"Svetlana Karslioglu","email":"skarslioglu@mirantis.com","username":"svekars"},"change_message_id":"0cb468014b75dff8403583ea9499707448e568a1","unresolved":false,"context_lines":[{"line_number":310,"context_line":"---------------------"},{"line_number":311,"context_line":""},{"line_number":312,"context_line":"Do not express your fears or feelings in technical writing by avoiding"},{"line_number":313,"context_line":"the adverbs such as `probably`, `hopefully`, `basically`, and so on."},{"line_number":314,"context_line":""},{"line_number":315,"context_line":"Do not use contractions"},{"line_number":316,"context_line":"-----------------------"}],"source_content_type":"text/x-rst","patch_set":10,"id":"ba15a1d1_362c6a01","line":313,"in_reply_to":"ba15a1d1_125dd946","updated":"2015-09-23 23:09:30.000000000","message":"Done","commit_id":"b35753b2dcd4e99224ba2377b72ca28ab1517a81"}],"doc/contributor-guide/source/writing-style/openstack-components.rst":[{"author":{"_account_id":9382,"name":"Shilla Saebi","email":"shilla.saebi@gmail.com","username":"shillasaebi"},"change_message_id":"2a10bd58a06a08009071891c5fa000cb5a194bdb","unresolved":false,"context_lines":[{"line_number":15,"context_line":""},{"line_number":16,"context_line":"   Use OpenStack, not Openstack or openstack."},{"line_number":17,"context_line":""},{"line_number":18,"context_line":"The following is the list of project names and their official names and"},{"line_number":19,"context_line":"capitalization:"},{"line_number":20,"context_line":""},{"line_number":21,"context_line":"* barbican: Key Manager service"}],"source_content_type":"text/x-rst","patch_set":2,"id":"da20952f_4066e0ed","line":18,"updated":"2015-09-05 22:01:05.000000000","message":"\"The following is the list of official project names and their capitalizations\"","commit_id":"2327d4714c50a4f71f7746f737e2509d47eaff7e"},{"author":{"_account_id":17626,"name":"Svetlana Karslioglu","email":"skarslioglu@mirantis.com","username":"svekars"},"change_message_id":"3b31de5d44f7634c3f97210cac6c218b45ac5ca5","unresolved":false,"context_lines":[{"line_number":15,"context_line":""},{"line_number":16,"context_line":"   Use OpenStack, not Openstack or openstack."},{"line_number":17,"context_line":""},{"line_number":18,"context_line":"The following is the list of project names and their official names and"},{"line_number":19,"context_line":"capitalization:"},{"line_number":20,"context_line":""},{"line_number":21,"context_line":"* barbican: Key Manager service"}],"source_content_type":"text/x-rst","patch_set":2,"id":"da20952f_963dd42e","line":18,"in_reply_to":"da20952f_4066e0ed","updated":"2015-09-08 18:35:51.000000000","message":"Done","commit_id":"2327d4714c50a4f71f7746f737e2509d47eaff7e"},{"author":{"_account_id":167,"name":"Christian Berendt","email":"berendt@osism.tech","username":"berendt"},"change_message_id":"e95c58d9c7622ce4c04897fd84c6d5845346aa69","unresolved":false,"context_lines":[{"line_number":16,"context_line":"   Use OpenStack, not Openstack or openstack."},{"line_number":17,"context_line":""},{"line_number":18,"context_line":"The following is the list of official project names and their"},{"line_number":19,"context_line":"capitalizations:"},{"line_number":20,"context_line":""},{"line_number":21,"context_line":"* barbican: Key Manager service"},{"line_number":22,"context_line":"* ceilometer: Telemetry service"}],"source_content_type":"text/x-rst","patch_set":8,"id":"ba15a1d1_e2a8ac79","line":19,"updated":"2015-09-22 18:58:22.000000000","message":"I would prefer to only reference/link https://github.com/openstack/governance/blob/master/reference/projects.yaml instead of maintaining our own list. For me it does not makes sense to duplicate the content of the projects.yaml file here.","commit_id":"27a7ea1c77d84695ec391bb71371b9ad901e9cfa"},{"author":{"_account_id":17626,"name":"Svetlana Karslioglu","email":"skarslioglu@mirantis.com","username":"svekars"},"change_message_id":"4f9fa6b1ae81cd137ab2a1fddf6614235cf71144","unresolved":false,"context_lines":[{"line_number":16,"context_line":"   Use OpenStack, not Openstack or openstack."},{"line_number":17,"context_line":""},{"line_number":18,"context_line":"The following is the list of official project names and their"},{"line_number":19,"context_line":"capitalizations:"},{"line_number":20,"context_line":""},{"line_number":21,"context_line":"* barbican: Key Manager service"},{"line_number":22,"context_line":"* ceilometer: Telemetry service"}],"source_content_type":"text/x-rst","patch_set":8,"id":"ba15a1d1_951b2580","line":19,"in_reply_to":"ba15a1d1_e2a8ac79","updated":"2015-09-22 20:47:34.000000000","message":"Done","commit_id":"27a7ea1c77d84695ec391bb71371b9ad901e9cfa"},{"author":{"_account_id":14947,"name":"Maria Zlatkova","email":"mzlatkova@mirantis.com","username":"mzlatkova"},"change_message_id":"c156e03a4bd91698e1b6a9dc1f6784e04a08500b","unresolved":false,"context_lines":[{"line_number":1,"context_line":".. _openstack_term:"},{"line_number":2,"context_line":""},{"line_number":3,"context_line":"OpenStack Components"},{"line_number":4,"context_line":"~~~~~~~~~~~~~~~~~~~~"},{"line_number":5,"context_line":""},{"line_number":6,"context_line":"When referring to the services, use `Compute,` `Image service`,"}],"source_content_type":"text/x-rst","patch_set":10,"id":"ba15a1d1_85d9a559","line":3,"updated":"2015-09-23 09:42:10.000000000","message":"Components --\u003e components","commit_id":"b35753b2dcd4e99224ba2377b72ca28ab1517a81"}],"doc/contributor-guide/source/writing-style/release-names.rst":[{"author":{"_account_id":14962,"name":"ologvinova","email":"ologvinova@mirantis.com","username":"ologvinova"},"change_message_id":"460ffc4638361b0be985d7d54834bb974956c06f","unresolved":false,"context_lines":[{"line_number":3,"context_line":"Release names"},{"line_number":4,"context_line":"~~~~~~~~~~~~~"},{"line_number":5,"context_line":""},{"line_number":6,"context_line":"Release Names should follow `the wiki page\u003chttps://wiki.openstack.org/wiki/Releases\u003e`_. "},{"line_number":7,"context_line":""},{"line_number":8,"context_line":"**Example:** "},{"line_number":9,"context_line":""}],"source_content_type":"text/x-rst","patch_set":1,"id":"da20952f_f69ccb6b","line":6,"updated":"2015-09-04 10:42:25.000000000","message":"Names -\u003e names","commit_id":"9ecff39ece7282cde9e3abd9e685970f0c4c5c46"},{"author":{"_account_id":17626,"name":"Svetlana Karslioglu","email":"skarslioglu@mirantis.com","username":"svekars"},"change_message_id":"f6cc28edcaca788fab2c7ec7cf30a41eeba56880","unresolved":false,"context_lines":[{"line_number":3,"context_line":"Release names"},{"line_number":4,"context_line":"~~~~~~~~~~~~~"},{"line_number":5,"context_line":""},{"line_number":6,"context_line":"Release Names should follow `the wiki page\u003chttps://wiki.openstack.org/wiki/Releases\u003e`_. "},{"line_number":7,"context_line":""},{"line_number":8,"context_line":"**Example:** "},{"line_number":9,"context_line":""}],"source_content_type":"text/x-rst","patch_set":1,"id":"da20952f_44404fa5","line":6,"in_reply_to":"da20952f_f69ccb6b","updated":"2015-09-04 18:41:45.000000000","message":"Good catch! and should \u003d\u003e must","commit_id":"9ecff39ece7282cde9e3abd9e685970f0c4c5c46"},{"author":{"_account_id":14643,"name":"Olga Gusarenko","email":"ogusarenko@mirantis.com","username":"Olga"},"change_message_id":"de676da2b33cd050c1c67318987c55851e28a25f","unresolved":false,"context_lines":[{"line_number":4,"context_line":"~~~~~~~~~~~~~"},{"line_number":5,"context_line":""},{"line_number":6,"context_line":"Use the names of the OpenStack releases as described on"},{"line_number":7,"context_line":" `this wiki page \u003chttps://wiki.openstack.org/wiki/Releases\u003e`_."},{"line_number":8,"context_line":""},{"line_number":9,"context_line":"**Example:**"},{"line_number":10,"context_line":""}],"source_content_type":"text/x-rst","patch_set":5,"id":"ba15a1d1_b5d21aff","line":7,"updated":"2015-09-15 09:04:36.000000000","message":"no indentation needed here as it looks like an option list when built. Please remove the whitespace before \" \u0027this wiki page ...\"","commit_id":"6e2957adacb2f83b3bcdfc081ab1b6e0e63e984f"},{"author":{"_account_id":167,"name":"Christian Berendt","email":"berendt@osism.tech","username":"berendt"},"change_message_id":"e95c58d9c7622ce4c04897fd84c6d5845346aa69","unresolved":false,"context_lines":[{"line_number":4,"context_line":"~~~~~~~~~~~~~"},{"line_number":5,"context_line":""},{"line_number":6,"context_line":"Use the names of the OpenStack releases as described on"},{"line_number":7,"context_line":" `this wiki page \u003chttps://wiki.openstack.org/wiki/Releases\u003e`_."},{"line_number":8,"context_line":""},{"line_number":9,"context_line":"**Example:**"},{"line_number":10,"context_line":""}],"source_content_type":"text/x-rst","patch_set":8,"id":"ba15a1d1_e2ed0cb8","line":7,"updated":"2015-09-22 18:58:22.000000000","message":"Do we not have a file in the governance repository tracking the releases?","commit_id":"27a7ea1c77d84695ec391bb71371b9ad901e9cfa"},{"author":{"_account_id":17626,"name":"Svetlana Karslioglu","email":"skarslioglu@mirantis.com","username":"svekars"},"change_message_id":"4f9fa6b1ae81cd137ab2a1fddf6614235cf71144","unresolved":false,"context_lines":[{"line_number":4,"context_line":"~~~~~~~~~~~~~"},{"line_number":5,"context_line":""},{"line_number":6,"context_line":"Use the names of the OpenStack releases as described on"},{"line_number":7,"context_line":" `this wiki page \u003chttps://wiki.openstack.org/wiki/Releases\u003e`_."},{"line_number":8,"context_line":""},{"line_number":9,"context_line":"**Example:**"},{"line_number":10,"context_line":""}],"source_content_type":"text/x-rst","patch_set":8,"id":"ba15a1d1_98027c08","line":7,"in_reply_to":"ba15a1d1_e2ed0cb8","updated":"2015-09-22 20:47:34.000000000","message":"I\u0027m not sure what you are suggesting here. Please elaborate.","commit_id":"27a7ea1c77d84695ec391bb71371b9ad901e9cfa"}],"doc/contributor-guide/source/writing-style/word-choice.rst":[{"author":{"_account_id":14962,"name":"ologvinova","email":"ologvinova@mirantis.com","username":"ologvinova"},"change_message_id":"460ffc4638361b0be985d7d54834bb974956c06f","unresolved":false,"context_lines":[{"line_number":6,"context_line":""},{"line_number":7,"context_line":"The following table lists the preferred word or phrase choice."},{"line_number":8,"context_line":""},{"line_number":9,"context_line":"**Preferred Word Choice**"},{"line_number":10,"context_line":""},{"line_number":11,"context_line":"+----------------+----------------------+"},{"line_number":12,"context_line":"|Word            |Do not use            |"}],"source_content_type":"text/x-rst","patch_set":1,"id":"da20952f_36a563a1","line":9,"updated":"2015-09-04 10:42:25.000000000","message":"sentence case capitalization","commit_id":"9ecff39ece7282cde9e3abd9e685970f0c4c5c46"},{"author":{"_account_id":17626,"name":"Svetlana Karslioglu","email":"skarslioglu@mirantis.com","username":"svekars"},"change_message_id":"f6cc28edcaca788fab2c7ec7cf30a41eeba56880","unresolved":false,"context_lines":[{"line_number":6,"context_line":""},{"line_number":7,"context_line":"The following table lists the preferred word or phrase choice."},{"line_number":8,"context_line":""},{"line_number":9,"context_line":"**Preferred Word Choice**"},{"line_number":10,"context_line":""},{"line_number":11,"context_line":"+----------------+----------------------+"},{"line_number":12,"context_line":"|Word            |Do not use            |"}],"source_content_type":"text/x-rst","patch_set":1,"id":"da20952f_a40dab90","line":9,"in_reply_to":"da20952f_36a563a1","updated":"2015-09-04 18:41:45.000000000","message":"Thanks! These are old habits \u003d)","commit_id":"9ecff39ece7282cde9e3abd9e685970f0c4c5c46"},{"author":{"_account_id":12847,"name":"Sheena Gregson","email":"sgregson@mirantis.com","username":"shenzorz"},"change_message_id":"947be71c965ccce827cc6b205ab9b07340b3ddbb","unresolved":false,"context_lines":[{"line_number":24,"context_line":"+----------------+----------------------+"},{"line_number":25,"context_line":"| complete       | done, finish         |"},{"line_number":26,"context_line":"+----------------+----------------------+"},{"line_number":27,"context_line":"| to do smth     | in order to          |"},{"line_number":28,"context_line":"+----------------+----------------------+"},{"line_number":29,"context_line":"| open           | launch               |"},{"line_number":30,"context_line":"+----------------+----------------------+"}],"source_content_type":"text/x-rst","patch_set":2,"id":"da20952f_685f590f","line":27,"updated":"2015-09-04 21:47:14.000000000","message":"smth -\u003e something?","commit_id":"2327d4714c50a4f71f7746f737e2509d47eaff7e"},{"author":{"_account_id":17626,"name":"Svetlana Karslioglu","email":"skarslioglu@mirantis.com","username":"svekars"},"change_message_id":"3b31de5d44f7634c3f97210cac6c218b45ac5ca5","unresolved":false,"context_lines":[{"line_number":24,"context_line":"+----------------+----------------------+"},{"line_number":25,"context_line":"| complete       | done, finish         |"},{"line_number":26,"context_line":"+----------------+----------------------+"},{"line_number":27,"context_line":"| to do smth     | in order to          |"},{"line_number":28,"context_line":"+----------------+----------------------+"},{"line_number":29,"context_line":"| open           | launch               |"},{"line_number":30,"context_line":"+----------------+----------------------+"}],"source_content_type":"text/x-rst","patch_set":2,"id":"da20952f_b6fd783d","line":27,"in_reply_to":"da20952f_685f590f","updated":"2015-09-08 18:35:51.000000000","message":"Done","commit_id":"2327d4714c50a4f71f7746f737e2509d47eaff7e"},{"author":{"_account_id":167,"name":"Christian Berendt","email":"berendt@osism.tech","username":"berendt"},"change_message_id":"e95c58d9c7622ce4c04897fd84c6d5845346aa69","unresolved":false,"context_lines":[{"line_number":10,"context_line":""},{"line_number":11,"context_line":"+----------------+----------------------+"},{"line_number":12,"context_line":"| **Word**       | **Do not use**       |"},{"line_number":13,"context_line":"+\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d+\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d+"},{"line_number":14,"context_line":"| cancel         | abort                |"},{"line_number":15,"context_line":"|                |                      |"},{"line_number":16,"context_line":"+----------------+----------------------+"}],"source_content_type":"text/x-rst","patch_set":8,"id":"ba15a1d1_223b043a","line":13,"updated":"2015-09-22 18:58:22.000000000","message":"Does it makes sense to sort this list alphabetically?","commit_id":"27a7ea1c77d84695ec391bb71371b9ad901e9cfa"},{"author":{"_account_id":17626,"name":"Svetlana Karslioglu","email":"skarslioglu@mirantis.com","username":"svekars"},"change_message_id":"4f9fa6b1ae81cd137ab2a1fddf6614235cf71144","unresolved":false,"context_lines":[{"line_number":10,"context_line":""},{"line_number":11,"context_line":"+----------------+----------------------+"},{"line_number":12,"context_line":"| **Word**       | **Do not use**       |"},{"line_number":13,"context_line":"+\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d+\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d+"},{"line_number":14,"context_line":"| cancel         | abort                |"},{"line_number":15,"context_line":"|                |                      |"},{"line_number":16,"context_line":"+----------------+----------------------+"}],"source_content_type":"text/x-rst","patch_set":8,"id":"ba15a1d1_f8ce1882","line":13,"in_reply_to":"ba15a1d1_223b043a","updated":"2015-09-22 20:47:34.000000000","message":"Done","commit_id":"27a7ea1c77d84695ec391bb71371b9ad901e9cfa"},{"author":{"_account_id":14947,"name":"Maria Zlatkova","email":"mzlatkova@mirantis.com","username":"mzlatkova"},"change_message_id":"c156e03a4bd91698e1b6a9dc1f6784e04a08500b","unresolved":false,"context_lines":[{"line_number":1,"context_line":""},{"line_number":2,"context_line":".. _stg_word_choice:"},{"line_number":3,"context_line":""},{"line_number":4,"context_line":"Word Choice"},{"line_number":5,"context_line":"~~~~~~~~~~~"},{"line_number":6,"context_line":""},{"line_number":7,"context_line":"The following table lists the preferred word or phrase choice."}],"source_content_type":"text/x-rst","patch_set":10,"id":"ba15a1d1_4522ada4","line":4,"updated":"2015-09-23 09:42:10.000000000","message":"Word Choice --\u003e Word choice","commit_id":"b35753b2dcd4e99224ba2377b72ca28ab1517a81"},{"author":{"_account_id":14947,"name":"Maria Zlatkova","email":"mzlatkova@mirantis.com","username":"mzlatkova"},"change_message_id":"c156e03a4bd91698e1b6a9dc1f6784e04a08500b","unresolved":false,"context_lines":[{"line_number":2,"context_line":".. _stg_word_choice:"},{"line_number":3,"context_line":""},{"line_number":4,"context_line":"Word Choice"},{"line_number":5,"context_line":"~~~~~~~~~~~"},{"line_number":6,"context_line":""},{"line_number":7,"context_line":"The following table lists the preferred word or phrase choice."},{"line_number":8,"context_line":""}],"source_content_type":"text/x-rst","patch_set":10,"id":"ba15a1d1_e542e13d","line":5,"updated":"2015-09-23 09:42:10.000000000","message":"Would be nice to provide the following links: http://docs.openstack.org/glossary/content/glossary.html and http://www-01.ibm.com/software/globalization/terminology/ Both links are given as reference here: https://wiki.openstack.org/wiki/Documentation/Conventions#Terms_and_usage\n\nCan be added into general-writing-guidelines.rst as well (line 17).","commit_id":"b35753b2dcd4e99224ba2377b72ca28ab1517a81"},{"author":{"_account_id":14947,"name":"Maria Zlatkova","email":"mzlatkova@mirantis.com","username":"mzlatkova"},"change_message_id":"c156e03a4bd91698e1b6a9dc1f6784e04a08500b","unresolved":false,"context_lines":[{"line_number":6,"context_line":""},{"line_number":7,"context_line":"The following table lists the preferred word or phrase choice."},{"line_number":8,"context_line":""},{"line_number":9,"context_line":"**Preferred Word Choice**"},{"line_number":10,"context_line":""},{"line_number":11,"context_line":"+----------------+----------------------+"},{"line_number":12,"context_line":"| **Word**       | **Do not use**       |"}],"source_content_type":"text/x-rst","patch_set":10,"id":"ba15a1d1_25a8d98b","line":9,"updated":"2015-09-23 09:42:10.000000000","message":"**Preferred word choice**","commit_id":"b35753b2dcd4e99224ba2377b72ca28ab1517a81"}]}