)]}'
{"doc/source/user/manage-recordsets.rst":[{"author":{"_account_id":11628,"name":"Michael Johnson","email":"johnsomor@gmail.com","username":"johnsom"},"change_message_id":"961da6250ea74aa21f2e4c941cc0c981b51a5767","unresolved":true,"context_lines":[{"line_number":22,"context_line":"\u0027resource records\u0027, or simply \u0027records\u0027, are used to store data within the"},{"line_number":23,"context_line":"namespace. Each record has a:"},{"line_number":24,"context_line":""},{"line_number":25,"context_line":"- ``Name`` that indicates its location in the DNS namespace;"},{"line_number":26,"context_line":"- ``Type`` that describes what sort of record this is, for example an ``MX``"},{"line_number":27,"context_line":"  record used for mail delivery or an ``NS`` record used for zone delegation;"},{"line_number":28,"context_line":"- ``Class`` which is most frequently set to ``IN`` for internet;"}],"source_content_type":"text/x-rst","patch_set":3,"id":"a1d4f748_d4b01891","line":25,"range":{"start_line":25,"start_character":59,"end_line":25,"end_character":60},"updated":"2021-05-18 23:01:20.000000000","message":"nit: Some have \u0027;\u0027 and some have \u0027.\u0027","commit_id":"d038c47bf83c3930e19c219efc6dab9d147f393c"},{"author":{"_account_id":6994,"name":"Michael Chapman","email":"woppin@gmail.com","username":"michaeltchapman"},"change_message_id":"9bd9e85b935f2b9a395f6dfeb2809dbf1724b35b","unresolved":false,"context_lines":[{"line_number":22,"context_line":"\u0027resource records\u0027, or simply \u0027records\u0027, are used to store data within the"},{"line_number":23,"context_line":"namespace. Each record has a:"},{"line_number":24,"context_line":""},{"line_number":25,"context_line":"- ``Name`` that indicates its location in the DNS namespace;"},{"line_number":26,"context_line":"- ``Type`` that describes what sort of record this is, for example an ``MX``"},{"line_number":27,"context_line":"  record used for mail delivery or an ``NS`` record used for zone delegation;"},{"line_number":28,"context_line":"- ``Class`` which is most frequently set to ``IN`` for internet;"}],"source_content_type":"text/x-rst","patch_set":3,"id":"98035367_cff9e2c1","line":25,"range":{"start_line":25,"start_character":59,"end_line":25,"end_character":60},"in_reply_to":"a1d4f748_d4b01891","updated":"2021-05-26 14:16:32.000000000","message":"Done","commit_id":"d038c47bf83c3930e19c219efc6dab9d147f393c"},{"author":{"_account_id":11628,"name":"Michael Johnson","email":"johnsomor@gmail.com","username":"johnsom"},"change_message_id":"961da6250ea74aa21f2e4c941cc0c981b51a5767","unresolved":true,"context_lines":[{"line_number":26,"context_line":"- ``Type`` that describes what sort of record this is, for example an ``MX``"},{"line_number":27,"context_line":"  record used for mail delivery or an ``NS`` record used for zone delegation;"},{"line_number":28,"context_line":"- ``Class`` which is most frequently set to ``IN`` for internet;"},{"line_number":29,"context_line":"- ``TTL`` Duration in seconds that the record will remain valid."},{"line_number":30,"context_line":"- ``Rdata`` which contains any data for the record, such as an IP address"},{"line_number":31,"context_line":"   for an ``A`` type record or another record name for a ``CNAME`` type record."},{"line_number":32,"context_line":""}],"source_content_type":"text/x-rst","patch_set":3,"id":"6b605e1e_42e03a6b","line":29,"range":{"start_line":29,"start_character":10,"end_line":29,"end_character":11},"updated":"2021-05-18 23:01:20.000000000","message":"nit: This one is capitalized, the others are not.","commit_id":"d038c47bf83c3930e19c219efc6dab9d147f393c"},{"author":{"_account_id":6994,"name":"Michael Chapman","email":"woppin@gmail.com","username":"michaeltchapman"},"change_message_id":"9bd9e85b935f2b9a395f6dfeb2809dbf1724b35b","unresolved":false,"context_lines":[{"line_number":26,"context_line":"- ``Type`` that describes what sort of record this is, for example an ``MX``"},{"line_number":27,"context_line":"  record used for mail delivery or an ``NS`` record used for zone delegation;"},{"line_number":28,"context_line":"- ``Class`` which is most frequently set to ``IN`` for internet;"},{"line_number":29,"context_line":"- ``TTL`` Duration in seconds that the record will remain valid."},{"line_number":30,"context_line":"- ``Rdata`` which contains any data for the record, such as an IP address"},{"line_number":31,"context_line":"   for an ``A`` type record or another record name for a ``CNAME`` type record."},{"line_number":32,"context_line":""}],"source_content_type":"text/x-rst","patch_set":3,"id":"0b1debaa_4f59a3e9","line":29,"range":{"start_line":29,"start_character":10,"end_line":29,"end_character":11},"in_reply_to":"6b605e1e_42e03a6b","updated":"2021-05-26 14:16:32.000000000","message":"Done","commit_id":"d038c47bf83c3930e19c219efc6dab9d147f393c"},{"author":{"_account_id":11628,"name":"Michael Johnson","email":"johnsomor@gmail.com","username":"johnsom"},"change_message_id":"961da6250ea74aa21f2e4c941cc0c981b51a5767","unresolved":true,"context_lines":[{"line_number":27,"context_line":"  record used for mail delivery or an ``NS`` record used for zone delegation;"},{"line_number":28,"context_line":"- ``Class`` which is most frequently set to ``IN`` for internet;"},{"line_number":29,"context_line":"- ``TTL`` Duration in seconds that the record will remain valid."},{"line_number":30,"context_line":"- ``Rdata`` which contains any data for the record, such as an IP address"},{"line_number":31,"context_line":"   for an ``A`` type record or another record name for a ``CNAME`` type record."},{"line_number":32,"context_line":""},{"line_number":33,"context_line":"More information about records and the the different types available can be"}],"source_content_type":"text/x-rst","patch_set":3,"id":"2dd3a35c_bcdb5baf","line":30,"updated":"2021-05-18 23:01:20.000000000","message":"This renders in bold for some reason. Maybe spacing of the next line?","commit_id":"d038c47bf83c3930e19c219efc6dab9d147f393c"},{"author":{"_account_id":6994,"name":"Michael Chapman","email":"woppin@gmail.com","username":"michaeltchapman"},"change_message_id":"9bd9e85b935f2b9a395f6dfeb2809dbf1724b35b","unresolved":false,"context_lines":[{"line_number":27,"context_line":"  record used for mail delivery or an ``NS`` record used for zone delegation;"},{"line_number":28,"context_line":"- ``Class`` which is most frequently set to ``IN`` for internet;"},{"line_number":29,"context_line":"- ``TTL`` Duration in seconds that the record will remain valid."},{"line_number":30,"context_line":"- ``Rdata`` which contains any data for the record, such as an IP address"},{"line_number":31,"context_line":"   for an ``A`` type record or another record name for a ``CNAME`` type record."},{"line_number":32,"context_line":""},{"line_number":33,"context_line":"More information about records and the the different types available can be"}],"source_content_type":"text/x-rst","patch_set":3,"id":"f6ac9747_beeec681","line":30,"in_reply_to":"2dd3a35c_bcdb5baf","updated":"2021-05-26 14:16:32.000000000","message":"I changed all the terms to be bold instead of literal and I think it looks a little bit better.","commit_id":"d038c47bf83c3930e19c219efc6dab9d147f393c"},{"author":{"_account_id":11628,"name":"Michael Johnson","email":"johnsomor@gmail.com","username":"johnsom"},"change_message_id":"961da6250ea74aa21f2e4c941cc0c981b51a5767","unresolved":true,"context_lines":[{"line_number":51,"context_line":"--------------------"},{"line_number":52,"context_line":""},{"line_number":53,"context_line":"By default, Recordsets can be created by any user in zones that are owned by"},{"line_number":54,"context_line":"their tenant. In this example it is assumed the user has already created"},{"line_number":55,"context_line":"a zone ``example.org.``."},{"line_number":56,"context_line":""},{"line_number":57,"context_line":"Recordsets are created using the ``openstack recordset create`` command, and"}],"source_content_type":"text/x-rst","patch_set":3,"id":"810ae793_97c35592","line":54,"range":{"start_line":54,"start_character":6,"end_line":54,"end_character":12},"updated":"2021-05-18 23:01:20.000000000","message":"nit: Openstack has moved from using the term tenant to project (driven by keystone).\nhttps://www.mail-archive.com/openstack-dev@lists.openstack.org/msg09709.html","commit_id":"d038c47bf83c3930e19c219efc6dab9d147f393c"},{"author":{"_account_id":6994,"name":"Michael Chapman","email":"woppin@gmail.com","username":"michaeltchapman"},"change_message_id":"9bd9e85b935f2b9a395f6dfeb2809dbf1724b35b","unresolved":false,"context_lines":[{"line_number":51,"context_line":"--------------------"},{"line_number":52,"context_line":""},{"line_number":53,"context_line":"By default, Recordsets can be created by any user in zones that are owned by"},{"line_number":54,"context_line":"their tenant. In this example it is assumed the user has already created"},{"line_number":55,"context_line":"a zone ``example.org.``."},{"line_number":56,"context_line":""},{"line_number":57,"context_line":"Recordsets are created using the ``openstack recordset create`` command, and"}],"source_content_type":"text/x-rst","patch_set":3,"id":"3936bac8_b45b1d27","line":54,"range":{"start_line":54,"start_character":6,"end_line":54,"end_character":12},"in_reply_to":"810ae793_97c35592","updated":"2021-05-26 14:16:32.000000000","message":"Done","commit_id":"d038c47bf83c3930e19c219efc6dab9d147f393c"},{"author":{"_account_id":11628,"name":"Michael Johnson","email":"johnsomor@gmail.com","username":"johnsom"},"change_message_id":"961da6250ea74aa21f2e4c941cc0c981b51a5767","unresolved":true,"context_lines":[{"line_number":72,"context_line":"      | id          | 549c3e83-443f-474b-b467-6bcd7cb9f37d |"},{"line_number":73,"context_line":"      | name        | www.example.org.                     |"},{"line_number":74,"context_line":"      | project_id  | c85fdba96041438fa0cad2dc7909d3f5     |"},{"line_number":75,"context_line":"      | records     | 10.0.0.1                             |"},{"line_number":76,"context_line":"      | status      | PENDING                              |"},{"line_number":77,"context_line":"      | ttl         | None                                 |"},{"line_number":78,"context_line":"      | type        | A                                    |"}],"source_content_type":"text/x-rst","patch_set":3,"id":"8d6ecc11_7cbaabd9","line":75,"range":{"start_line":75,"start_character":22,"end_line":75,"end_character":30},"updated":"2021-05-18 23:01:20.000000000","message":"nit: In documentation we should use one of the reserved for documentation ip address spaces:\n\n192.0.2.0/24\n198.51.100.0/24\n203.0.113.0/24","commit_id":"d038c47bf83c3930e19c219efc6dab9d147f393c"},{"author":{"_account_id":6994,"name":"Michael Chapman","email":"woppin@gmail.com","username":"michaeltchapman"},"change_message_id":"9bd9e85b935f2b9a395f6dfeb2809dbf1724b35b","unresolved":false,"context_lines":[{"line_number":72,"context_line":"      | id          | 549c3e83-443f-474b-b467-6bcd7cb9f37d |"},{"line_number":73,"context_line":"      | name        | www.example.org.                     |"},{"line_number":74,"context_line":"      | project_id  | c85fdba96041438fa0cad2dc7909d3f5     |"},{"line_number":75,"context_line":"      | records     | 10.0.0.1                             |"},{"line_number":76,"context_line":"      | status      | PENDING                              |"},{"line_number":77,"context_line":"      | ttl         | None                                 |"},{"line_number":78,"context_line":"      | type        | A                                    |"}],"source_content_type":"text/x-rst","patch_set":3,"id":"25976873_ee663a09","line":75,"range":{"start_line":75,"start_character":22,"end_line":75,"end_character":30},"in_reply_to":"8d6ecc11_7cbaabd9","updated":"2021-05-26 14:16:32.000000000","message":"Changed the sample nameserver to 203. and the records to 192.","commit_id":"d038c47bf83c3930e19c219efc6dab9d147f393c"},{"author":{"_account_id":11628,"name":"Michael Johnson","email":"johnsomor@gmail.com","username":"johnsom"},"change_message_id":"961da6250ea74aa21f2e4c941cc0c981b51a5767","unresolved":true,"context_lines":[{"line_number":87,"context_line":"had ``www.example.org.`` been used. Note that the trailing ``.`` is essential -"},{"line_number":88,"context_line":"its omission would result in a name of ``www.example.org.example.org.``."},{"line_number":89,"context_line":""},{"line_number":90,"context_line":"``--record`` can be supplied multiple times to create multiple records within"},{"line_number":91,"context_line":"the recordset. Since there cannot be two recordsets with the same name and"},{"line_number":92,"context_line":"type, this one will need a different name:"},{"line_number":93,"context_line":""}],"source_content_type":"text/x-rst","patch_set":3,"id":"17a7fb44_c07244cf","line":90,"range":{"start_line":90,"start_character":29,"end_line":90,"end_character":70},"updated":"2021-05-18 23:01:20.000000000","message":"It might be nice to have a small mention of why someone might want to have multiple records. I.e. for round robin\nPeople that are new to DNS might assume it is used for some sort of failover, or ...","commit_id":"d038c47bf83c3930e19c219efc6dab9d147f393c"},{"author":{"_account_id":6994,"name":"Michael Chapman","email":"woppin@gmail.com","username":"michaeltchapman"},"change_message_id":"9bd9e85b935f2b9a395f6dfeb2809dbf1724b35b","unresolved":false,"context_lines":[{"line_number":87,"context_line":"had ``www.example.org.`` been used. Note that the trailing ``.`` is essential -"},{"line_number":88,"context_line":"its omission would result in a name of ``www.example.org.example.org.``."},{"line_number":89,"context_line":""},{"line_number":90,"context_line":"``--record`` can be supplied multiple times to create multiple records within"},{"line_number":91,"context_line":"the recordset. Since there cannot be two recordsets with the same name and"},{"line_number":92,"context_line":"type, this one will need a different name:"},{"line_number":93,"context_line":""}],"source_content_type":"text/x-rst","patch_set":3,"id":"13c27e71_b7058c77","line":90,"range":{"start_line":90,"start_character":29,"end_line":90,"end_character":70},"in_reply_to":"17a7fb44_c07244cf","updated":"2021-05-26 14:16:32.000000000","message":"Done","commit_id":"d038c47bf83c3930e19c219efc6dab9d147f393c"},{"author":{"_account_id":11628,"name":"Michael Johnson","email":"johnsomor@gmail.com","username":"johnsom"},"change_message_id":"961da6250ea74aa21f2e4c941cc0c981b51a5767","unresolved":true,"context_lines":[{"line_number":88,"context_line":"its omission would result in a name of ``www.example.org.example.org.``."},{"line_number":89,"context_line":""},{"line_number":90,"context_line":"``--record`` can be supplied multiple times to create multiple records within"},{"line_number":91,"context_line":"the recordset. Since there cannot be two recordsets with the same name and"},{"line_number":92,"context_line":"type, this one will need a different name:"},{"line_number":93,"context_line":""},{"line_number":94,"context_line":"   .. code-block:: console"},{"line_number":95,"context_line":""}],"source_content_type":"text/x-rst","patch_set":3,"id":"6da17d0b_406f1b86","line":92,"range":{"start_line":91,"start_character":15,"end_line":92,"end_character":42},"updated":"2021-05-18 23:01:20.000000000","message":"This sentence is a bit confusing to me. Maybe just change it to be a new \"example\"?\n\nFor example, if we wanted to create a record for web.example.org, with two addresses, we would run:","commit_id":"d038c47bf83c3930e19c219efc6dab9d147f393c"},{"author":{"_account_id":6994,"name":"Michael Chapman","email":"woppin@gmail.com","username":"michaeltchapman"},"change_message_id":"9bd9e85b935f2b9a395f6dfeb2809dbf1724b35b","unresolved":false,"context_lines":[{"line_number":88,"context_line":"its omission would result in a name of ``www.example.org.example.org.``."},{"line_number":89,"context_line":""},{"line_number":90,"context_line":"``--record`` can be supplied multiple times to create multiple records within"},{"line_number":91,"context_line":"the recordset. Since there cannot be two recordsets with the same name and"},{"line_number":92,"context_line":"type, this one will need a different name:"},{"line_number":93,"context_line":""},{"line_number":94,"context_line":"   .. code-block:: console"},{"line_number":95,"context_line":""}],"source_content_type":"text/x-rst","patch_set":3,"id":"317cfa51_0e8db19c","line":92,"range":{"start_line":91,"start_character":15,"end_line":92,"end_character":42},"in_reply_to":"6da17d0b_406f1b86","updated":"2021-05-26 14:16:32.000000000","message":"Done","commit_id":"d038c47bf83c3930e19c219efc6dab9d147f393c"},{"author":{"_account_id":11628,"name":"Michael Johnson","email":"johnsomor@gmail.com","username":"johnsom"},"change_message_id":"961da6250ea74aa21f2e4c941cc0c981b51a5767","unresolved":true,"context_lines":[{"line_number":122,"context_line":"       +--------------------------------------+------------------+------+---------------------------------------------------------------------+--------+--------+"},{"line_number":123,"context_line":"       | id                                   | name             | type | records                                                             | status | action |"},{"line_number":124,"context_line":"       +--------------------------------------+------------------+------+---------------------------------------------------------------------+--------+--------+"},{"line_number":125,"context_line":"       | 3bebbd03-07d7-4274-a784-39c32a2be8c6 | example.org.     | SOA  | ns1.devstack.org. admin.example.org. 1620012616 3599 600 86400 3600 | ACTIVE | NONE   |"},{"line_number":126,"context_line":"       | 7d34e4d3-a2f1-4af0-831c-ba52a8312c6a | example.org.     | NS   | ns1.devstack.org.                                                   | ACTIVE | NONE   |"},{"line_number":127,"context_line":"       | 9e0fba43-ca67-44ed-b9d9-fc1242920319 | web.example.org. | A    | 10.0.0.1                                                            | ACTIVE | NONE   |"},{"line_number":128,"context_line":"       |                                      |                  |      | 10.0.0.2                                                            |        |        |"}],"source_content_type":"text/x-rst","patch_set":3,"id":"72cccac9_6ade7fcf","line":125,"range":{"start_line":125,"start_character":78,"end_line":125,"end_character":86},"updated":"2021-05-18 23:01:20.000000000","message":"Please use the \"example\" domains in these docs. Someone owns devstack.org which may or may not point to the right place in the future.\nns1.example.net?","commit_id":"d038c47bf83c3930e19c219efc6dab9d147f393c"},{"author":{"_account_id":6994,"name":"Michael Chapman","email":"woppin@gmail.com","username":"michaeltchapman"},"change_message_id":"9bd9e85b935f2b9a395f6dfeb2809dbf1724b35b","unresolved":false,"context_lines":[{"line_number":122,"context_line":"       +--------------------------------------+------------------+------+---------------------------------------------------------------------+--------+--------+"},{"line_number":123,"context_line":"       | id                                   | name             | type | records                                                             | status | action |"},{"line_number":124,"context_line":"       +--------------------------------------+------------------+------+---------------------------------------------------------------------+--------+--------+"},{"line_number":125,"context_line":"       | 3bebbd03-07d7-4274-a784-39c32a2be8c6 | example.org.     | SOA  | ns1.devstack.org. admin.example.org. 1620012616 3599 600 86400 3600 | ACTIVE | NONE   |"},{"line_number":126,"context_line":"       | 7d34e4d3-a2f1-4af0-831c-ba52a8312c6a | example.org.     | NS   | ns1.devstack.org.                                                   | ACTIVE | NONE   |"},{"line_number":127,"context_line":"       | 9e0fba43-ca67-44ed-b9d9-fc1242920319 | web.example.org. | A    | 10.0.0.1                                                            | ACTIVE | NONE   |"},{"line_number":128,"context_line":"       |                                      |                  |      | 10.0.0.2                                                            |        |        |"}],"source_content_type":"text/x-rst","patch_set":3,"id":"0bb20995_abd08591","line":125,"range":{"start_line":125,"start_character":78,"end_line":125,"end_character":86},"in_reply_to":"72cccac9_6ade7fcf","updated":"2021-05-26 14:16:32.000000000","message":"Done","commit_id":"d038c47bf83c3930e19c219efc6dab9d147f393c"},{"author":{"_account_id":11628,"name":"Michael Johnson","email":"johnsomor@gmail.com","username":"johnsom"},"change_message_id":"961da6250ea74aa21f2e4c941cc0c981b51a5767","unresolved":true,"context_lines":[{"line_number":227,"context_line":"Deleting a recordset"},{"line_number":228,"context_line":"--------------------"},{"line_number":229,"context_line":""},{"line_number":230,"context_line":"Since the ``web.example.org.`` record is now no longer needed, it can be"},{"line_number":231,"context_line":"deleted and our records will match the example requirements we initially"},{"line_number":232,"context_line":"set out:"},{"line_number":233,"context_line":""}],"source_content_type":"text/x-rst","patch_set":3,"id":"d2269dc4_da074a02","line":230,"range":{"start_line":230,"start_character":0,"end_line":230,"end_character":61},"updated":"2021-05-18 23:01:20.000000000","message":"This might be confusing to new users, especially if they navigated directly to this section.","commit_id":"d038c47bf83c3930e19c219efc6dab9d147f393c"},{"author":{"_account_id":6994,"name":"Michael Chapman","email":"woppin@gmail.com","username":"michaeltchapman"},"change_message_id":"9bd9e85b935f2b9a395f6dfeb2809dbf1724b35b","unresolved":false,"context_lines":[{"line_number":227,"context_line":"Deleting a recordset"},{"line_number":228,"context_line":"--------------------"},{"line_number":229,"context_line":""},{"line_number":230,"context_line":"Since the ``web.example.org.`` record is now no longer needed, it can be"},{"line_number":231,"context_line":"deleted and our records will match the example requirements we initially"},{"line_number":232,"context_line":"set out:"},{"line_number":233,"context_line":""}],"source_content_type":"text/x-rst","patch_set":3,"id":"ceb58e7a_733de8b8","line":230,"range":{"start_line":230,"start_character":0,"end_line":230,"end_character":61},"in_reply_to":"d2269dc4_da074a02","updated":"2021-05-26 14:16:32.000000000","message":"Done","commit_id":"d038c47bf83c3930e19c219efc6dab9d147f393c"},{"author":{"_account_id":19298,"name":"Nicolas Bock","email":"nicolas.bock@canonical.com","username":"nicolasbock"},"change_message_id":"d28dfa9be3bdcdf346c4ab315b974d67a482bc61","unresolved":true,"context_lines":[{"line_number":28,"context_line":"- **Class** which is most frequently set to ``IN`` for internet;"},{"line_number":29,"context_line":"- **TTL** duration in seconds that the record will remain valid;"},{"line_number":30,"context_line":"- **Rdata** which contains any data for the record, such as an IP address"},{"line_number":31,"context_line":"   for an ``A`` type record or another record name for a ``CNAME`` type record."},{"line_number":32,"context_line":""},{"line_number":33,"context_line":"More information about records and the the different types available can be"},{"line_number":34,"context_line":"found at https://en.wikipedia.org/wiki/List_of_DNS_record_types and in the RFC"}],"source_content_type":"text/x-rst","patch_set":5,"id":"6cc79672_a0e66c1e","line":31,"updated":"2021-05-19 12:41:56.000000000","message":"Move `for` one column to the left otherwise this item gets rendered incorrectly.","commit_id":"4019bd6c2a7fa9c2a2504d7e2a96487e6cc27f60"},{"author":{"_account_id":6994,"name":"Michael Chapman","email":"woppin@gmail.com","username":"michaeltchapman"},"change_message_id":"9bd9e85b935f2b9a395f6dfeb2809dbf1724b35b","unresolved":false,"context_lines":[{"line_number":28,"context_line":"- **Class** which is most frequently set to ``IN`` for internet;"},{"line_number":29,"context_line":"- **TTL** duration in seconds that the record will remain valid;"},{"line_number":30,"context_line":"- **Rdata** which contains any data for the record, such as an IP address"},{"line_number":31,"context_line":"   for an ``A`` type record or another record name for a ``CNAME`` type record."},{"line_number":32,"context_line":""},{"line_number":33,"context_line":"More information about records and the the different types available can be"},{"line_number":34,"context_line":"found at https://en.wikipedia.org/wiki/List_of_DNS_record_types and in the RFC"}],"source_content_type":"text/x-rst","patch_set":5,"id":"83edc056_f5bae737","line":31,"in_reply_to":"6cc79672_a0e66c1e","updated":"2021-05-26 14:16:32.000000000","message":"Done","commit_id":"4019bd6c2a7fa9c2a2504d7e2a96487e6cc27f60"},{"author":{"_account_id":19298,"name":"Nicolas Bock","email":"nicolas.bock@canonical.com","username":"nicolasbock"},"change_message_id":"d28dfa9be3bdcdf346c4ab315b974d67a482bc61","unresolved":true,"context_lines":[{"line_number":54,"context_line":"their project. In this example it is assumed the user has already created"},{"line_number":55,"context_line":"a zone ``example.org.``."},{"line_number":56,"context_line":""},{"line_number":57,"context_line":"Recordsets are created using the ``openstack recordset create`` command, and"},{"line_number":58,"context_line":"require a zone, a name, a type and data for the record."},{"line_number":59,"context_line":"To recreate the earlier example using the openstack client with the designate"},{"line_number":60,"context_line":"plugin, the user would therefore run:"}],"source_content_type":"text/x-rst","patch_set":5,"id":"2a98ccde_0bc8b968","line":57,"updated":"2021-05-19 12:41:56.000000000","message":"Remove the comma after \u0027command\u0027.","commit_id":"4019bd6c2a7fa9c2a2504d7e2a96487e6cc27f60"},{"author":{"_account_id":6994,"name":"Michael Chapman","email":"woppin@gmail.com","username":"michaeltchapman"},"change_message_id":"9bd9e85b935f2b9a395f6dfeb2809dbf1724b35b","unresolved":false,"context_lines":[{"line_number":54,"context_line":"their project. In this example it is assumed the user has already created"},{"line_number":55,"context_line":"a zone ``example.org.``."},{"line_number":56,"context_line":""},{"line_number":57,"context_line":"Recordsets are created using the ``openstack recordset create`` command, and"},{"line_number":58,"context_line":"require a zone, a name, a type and data for the record."},{"line_number":59,"context_line":"To recreate the earlier example using the openstack client with the designate"},{"line_number":60,"context_line":"plugin, the user would therefore run:"}],"source_content_type":"text/x-rst","patch_set":5,"id":"a18c8ebf_a5c247bc","line":57,"in_reply_to":"2a98ccde_0bc8b968","updated":"2021-05-26 14:16:32.000000000","message":"Done","commit_id":"4019bd6c2a7fa9c2a2504d7e2a96487e6cc27f60"},{"author":{"_account_id":19298,"name":"Nicolas Bock","email":"nicolas.bock@canonical.com","username":"nicolasbock"},"change_message_id":"d28dfa9be3bdcdf346c4ab315b974d67a482bc61","unresolved":true,"context_lines":[{"line_number":55,"context_line":"a zone ``example.org.``."},{"line_number":56,"context_line":""},{"line_number":57,"context_line":"Recordsets are created using the ``openstack recordset create`` command, and"},{"line_number":58,"context_line":"require a zone, a name, a type and data for the record."},{"line_number":59,"context_line":"To recreate the earlier example using the openstack client with the designate"},{"line_number":60,"context_line":"plugin, the user would therefore run:"},{"line_number":61,"context_line":""}],"source_content_type":"text/x-rst","patch_set":5,"id":"f6566f2f_4b6fdcd3","line":58,"updated":"2021-05-19 12:41:56.000000000","message":"The \"Oxford Comma\" is missing ;)","commit_id":"4019bd6c2a7fa9c2a2504d7e2a96487e6cc27f60"},{"author":{"_account_id":6994,"name":"Michael Chapman","email":"woppin@gmail.com","username":"michaeltchapman"},"change_message_id":"9bd9e85b935f2b9a395f6dfeb2809dbf1724b35b","unresolved":false,"context_lines":[{"line_number":55,"context_line":"a zone ``example.org.``."},{"line_number":56,"context_line":""},{"line_number":57,"context_line":"Recordsets are created using the ``openstack recordset create`` command, and"},{"line_number":58,"context_line":"require a zone, a name, a type and data for the record."},{"line_number":59,"context_line":"To recreate the earlier example using the openstack client with the designate"},{"line_number":60,"context_line":"plugin, the user would therefore run:"},{"line_number":61,"context_line":""}],"source_content_type":"text/x-rst","patch_set":5,"id":"1e7d76ef_3620805b","line":58,"in_reply_to":"f6566f2f_4b6fdcd3","updated":"2021-05-26 14:16:32.000000000","message":"Ack","commit_id":"4019bd6c2a7fa9c2a2504d7e2a96487e6cc27f60"},{"author":{"_account_id":19298,"name":"Nicolas Bock","email":"nicolas.bock@canonical.com","username":"nicolasbock"},"change_message_id":"d28dfa9be3bdcdf346c4ab315b974d67a482bc61","unresolved":true,"context_lines":[{"line_number":84,"context_line":""},{"line_number":85,"context_line":"As the final argument ``www`` is not a fully qualified domain name (FQDN) it"},{"line_number":86,"context_line":"will be prepended to the zone name, but the same result would be achieved"},{"line_number":87,"context_line":"had ``www.example.org.`` been used. Note that the trailing ``.`` is essential -"},{"line_number":88,"context_line":"its omission would result in a name of ``www.example.org.example.org.``."},{"line_number":89,"context_line":""},{"line_number":90,"context_line":"``--record`` can be supplied multiple times to create multiple records within"}],"source_content_type":"text/x-rst","patch_set":5,"id":"8d55d346_5f1f3f7d","line":87,"updated":"2021-05-19 12:41:56.000000000","message":"Use `---` instead of `-`.","commit_id":"4019bd6c2a7fa9c2a2504d7e2a96487e6cc27f60"},{"author":{"_account_id":6994,"name":"Michael Chapman","email":"woppin@gmail.com","username":"michaeltchapman"},"change_message_id":"9bd9e85b935f2b9a395f6dfeb2809dbf1724b35b","unresolved":false,"context_lines":[{"line_number":84,"context_line":""},{"line_number":85,"context_line":"As the final argument ``www`` is not a fully qualified domain name (FQDN) it"},{"line_number":86,"context_line":"will be prepended to the zone name, but the same result would be achieved"},{"line_number":87,"context_line":"had ``www.example.org.`` been used. Note that the trailing ``.`` is essential -"},{"line_number":88,"context_line":"its omission would result in a name of ``www.example.org.example.org.``."},{"line_number":89,"context_line":""},{"line_number":90,"context_line":"``--record`` can be supplied multiple times to create multiple records within"}],"source_content_type":"text/x-rst","patch_set":5,"id":"ce1fbf6a_4b33367a","line":87,"in_reply_to":"8d55d346_5f1f3f7d","updated":"2021-05-26 14:16:32.000000000","message":"Done","commit_id":"4019bd6c2a7fa9c2a2504d7e2a96487e6cc27f60"},{"author":{"_account_id":19298,"name":"Nicolas Bock","email":"nicolas.bock@canonical.com","username":"nicolasbock"},"change_message_id":"d28dfa9be3bdcdf346c4ab315b974d67a482bc61","unresolved":true,"context_lines":[{"line_number":85,"context_line":"As the final argument ``www`` is not a fully qualified domain name (FQDN) it"},{"line_number":86,"context_line":"will be prepended to the zone name, but the same result would be achieved"},{"line_number":87,"context_line":"had ``www.example.org.`` been used. Note that the trailing ``.`` is essential -"},{"line_number":88,"context_line":"its omission would result in a name of ``www.example.org.example.org.``."},{"line_number":89,"context_line":""},{"line_number":90,"context_line":"``--record`` can be supplied multiple times to create multiple records within"},{"line_number":91,"context_line":"the recordset, for example for `Round-robin DNS`_."}],"source_content_type":"text/x-rst","patch_set":5,"id":"3b84edeb_a9d7cbd7","line":88,"updated":"2021-05-19 12:41:56.000000000","message":"Maybe wrap the name in quotes to clearly separate the `.` of the name from the `.` of the sentence.","commit_id":"4019bd6c2a7fa9c2a2504d7e2a96487e6cc27f60"},{"author":{"_account_id":6994,"name":"Michael Chapman","email":"woppin@gmail.com","username":"michaeltchapman"},"change_message_id":"9bd9e85b935f2b9a395f6dfeb2809dbf1724b35b","unresolved":false,"context_lines":[{"line_number":85,"context_line":"As the final argument ``www`` is not a fully qualified domain name (FQDN) it"},{"line_number":86,"context_line":"will be prepended to the zone name, but the same result would be achieved"},{"line_number":87,"context_line":"had ``www.example.org.`` been used. Note that the trailing ``.`` is essential -"},{"line_number":88,"context_line":"its omission would result in a name of ``www.example.org.example.org.``."},{"line_number":89,"context_line":""},{"line_number":90,"context_line":"``--record`` can be supplied multiple times to create multiple records within"},{"line_number":91,"context_line":"the recordset, for example for `Round-robin DNS`_."}],"source_content_type":"text/x-rst","patch_set":5,"id":"d37b14c7_2de27706","line":88,"in_reply_to":"3b84edeb_a9d7cbd7","updated":"2021-05-26 14:16:32.000000000","message":"Done","commit_id":"4019bd6c2a7fa9c2a2504d7e2a96487e6cc27f60"},{"author":{"_account_id":19298,"name":"Nicolas Bock","email":"nicolas.bock@canonical.com","username":"nicolasbock"},"change_message_id":"d28dfa9be3bdcdf346c4ab315b974d67a482bc61","unresolved":true,"context_lines":[{"line_number":87,"context_line":"had ``www.example.org.`` been used. Note that the trailing ``.`` is essential -"},{"line_number":88,"context_line":"its omission would result in a name of ``www.example.org.example.org.``."},{"line_number":89,"context_line":""},{"line_number":90,"context_line":"``--record`` can be supplied multiple times to create multiple records within"},{"line_number":91,"context_line":"the recordset, for example for `Round-robin DNS`_."},{"line_number":92,"context_line":""},{"line_number":93,"context_line":""}],"source_content_type":"text/x-rst","patch_set":5,"id":"0759bacc_54042a0f","line":90,"updated":"2021-05-19 12:41:56.000000000","message":"The ``--record`` argument can be ....","commit_id":"4019bd6c2a7fa9c2a2504d7e2a96487e6cc27f60"},{"author":{"_account_id":6994,"name":"Michael Chapman","email":"woppin@gmail.com","username":"michaeltchapman"},"change_message_id":"9bd9e85b935f2b9a395f6dfeb2809dbf1724b35b","unresolved":false,"context_lines":[{"line_number":87,"context_line":"had ``www.example.org.`` been used. Note that the trailing ``.`` is essential -"},{"line_number":88,"context_line":"its omission would result in a name of ``www.example.org.example.org.``."},{"line_number":89,"context_line":""},{"line_number":90,"context_line":"``--record`` can be supplied multiple times to create multiple records within"},{"line_number":91,"context_line":"the recordset, for example for `Round-robin DNS`_."},{"line_number":92,"context_line":""},{"line_number":93,"context_line":""}],"source_content_type":"text/x-rst","patch_set":5,"id":"6320da08_d778f6ce","line":90,"in_reply_to":"0759bacc_54042a0f","updated":"2021-05-26 14:16:32.000000000","message":"Done","commit_id":"4019bd6c2a7fa9c2a2504d7e2a96487e6cc27f60"},{"author":{"_account_id":19298,"name":"Nicolas Bock","email":"nicolas.bock@canonical.com","username":"nicolasbock"},"change_message_id":"d28dfa9be3bdcdf346c4ab315b974d67a482bc61","unresolved":true,"context_lines":[{"line_number":129,"context_line":"       | 549c3e83-443f-474b-b467-6bcd7cb9f37d | www.example.org. | A    | 192.0.2.1                                                           | ACTIVE | NONE   |"},{"line_number":130,"context_line":"       +--------------------------------------+------------------+------+---------------------------------------------------------------------+--------+--------+"},{"line_number":131,"context_line":""},{"line_number":132,"context_line":"The SOA and NS records for the zone are also visible here, but cannot be"},{"line_number":133,"context_line":"modified by regular users. Users with the admin role can modify these records"},{"line_number":134,"context_line":"with the ``--edit-managed`` option, though this is not likely to be a common"},{"line_number":135,"context_line":"operation."}],"source_content_type":"text/x-rst","patch_set":5,"id":"f599fa02_d3230f80","line":132,"updated":"2021-05-19 12:41:56.000000000","message":"Emphasize ``SOA` and ``NS``","commit_id":"4019bd6c2a7fa9c2a2504d7e2a96487e6cc27f60"},{"author":{"_account_id":6994,"name":"Michael Chapman","email":"woppin@gmail.com","username":"michaeltchapman"},"change_message_id":"9bd9e85b935f2b9a395f6dfeb2809dbf1724b35b","unresolved":false,"context_lines":[{"line_number":129,"context_line":"       | 549c3e83-443f-474b-b467-6bcd7cb9f37d | www.example.org. | A    | 192.0.2.1                                                           | ACTIVE | NONE   |"},{"line_number":130,"context_line":"       +--------------------------------------+------------------+------+---------------------------------------------------------------------+--------+--------+"},{"line_number":131,"context_line":""},{"line_number":132,"context_line":"The SOA and NS records for the zone are also visible here, but cannot be"},{"line_number":133,"context_line":"modified by regular users. Users with the admin role can modify these records"},{"line_number":134,"context_line":"with the ``--edit-managed`` option, though this is not likely to be a common"},{"line_number":135,"context_line":"operation."}],"source_content_type":"text/x-rst","patch_set":5,"id":"7c29a39c_37029419","line":132,"in_reply_to":"f599fa02_d3230f80","updated":"2021-05-26 14:16:32.000000000","message":"Done","commit_id":"4019bd6c2a7fa9c2a2504d7e2a96487e6cc27f60"},{"author":{"_account_id":13252,"name":"Dr. Jens Harbott","display_name":"Jens Harbott (frickler)","email":"frickler@offenerstapel.de","username":"jrosenboom"},"change_message_id":"945d06ca02e791ed8d6b58952219383f21b7b93d","unresolved":true,"context_lines":[{"line_number":30,"context_line":"- **Rdata** which contains any data for the record, such as an IP address"},{"line_number":31,"context_line":"  for an ``A`` type record or another record name for a ``CNAME`` type record."},{"line_number":32,"context_line":""},{"line_number":33,"context_line":"More information about records and the the different types available can be"},{"line_number":34,"context_line":"found at https://en.wikipedia.org/wiki/List_of_DNS_record_types and in the RFC"},{"line_number":35,"context_line":"https://tools.ietf.org/html/rfc1035#section-3.2"},{"line_number":36,"context_line":""}],"source_content_type":"text/x-rst","patch_set":6,"id":"9e55ff84_3f13d37c","line":33,"range":{"start_line":33,"start_character":35,"end_line":33,"end_character":42},"updated":"2021-05-20 15:26:59.000000000","message":"duplicate","commit_id":"235d0196e87b6d2a929e16533032d54599cf257b"},{"author":{"_account_id":6994,"name":"Michael Chapman","email":"woppin@gmail.com","username":"michaeltchapman"},"change_message_id":"9bd9e85b935f2b9a395f6dfeb2809dbf1724b35b","unresolved":false,"context_lines":[{"line_number":30,"context_line":"- **Rdata** which contains any data for the record, such as an IP address"},{"line_number":31,"context_line":"  for an ``A`` type record or another record name for a ``CNAME`` type record."},{"line_number":32,"context_line":""},{"line_number":33,"context_line":"More information about records and the the different types available can be"},{"line_number":34,"context_line":"found at https://en.wikipedia.org/wiki/List_of_DNS_record_types and in the RFC"},{"line_number":35,"context_line":"https://tools.ietf.org/html/rfc1035#section-3.2"},{"line_number":36,"context_line":""}],"source_content_type":"text/x-rst","patch_set":6,"id":"bcff2258_90f7c192","line":33,"range":{"start_line":33,"start_character":35,"end_line":33,"end_character":42},"in_reply_to":"9e55ff84_3f13d37c","updated":"2021-05-26 14:16:32.000000000","message":"Done","commit_id":"235d0196e87b6d2a929e16533032d54599cf257b"},{"author":{"_account_id":13252,"name":"Dr. Jens Harbott","display_name":"Jens Harbott (frickler)","email":"frickler@offenerstapel.de","username":"jrosenboom"},"change_message_id":"945d06ca02e791ed8d6b58952219383f21b7b93d","unresolved":true,"context_lines":[{"line_number":32,"context_line":""},{"line_number":33,"context_line":"More information about records and the the different types available can be"},{"line_number":34,"context_line":"found at https://en.wikipedia.org/wiki/List_of_DNS_record_types and in the RFC"},{"line_number":35,"context_line":"https://tools.ietf.org/html/rfc1035#section-3.2"},{"line_number":36,"context_line":""},{"line_number":37,"context_line":"Recordsets in Designate"},{"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"}],"source_content_type":"text/x-rst","patch_set":6,"id":"4bed1832_da949d25","line":35,"updated":"2021-05-20 15:26:59.000000000","message":"Missing \".\" at the end of the sentence","commit_id":"235d0196e87b6d2a929e16533032d54599cf257b"},{"author":{"_account_id":6994,"name":"Michael Chapman","email":"woppin@gmail.com","username":"michaeltchapman"},"change_message_id":"9bd9e85b935f2b9a395f6dfeb2809dbf1724b35b","unresolved":false,"context_lines":[{"line_number":32,"context_line":""},{"line_number":33,"context_line":"More information about records and the the different types available can be"},{"line_number":34,"context_line":"found at https://en.wikipedia.org/wiki/List_of_DNS_record_types and in the RFC"},{"line_number":35,"context_line":"https://tools.ietf.org/html/rfc1035#section-3.2"},{"line_number":36,"context_line":""},{"line_number":37,"context_line":"Recordsets in Designate"},{"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"}],"source_content_type":"text/x-rst","patch_set":6,"id":"91799380_a0764f90","line":35,"in_reply_to":"4bed1832_da949d25","updated":"2021-05-26 14:16:32.000000000","message":"Done","commit_id":"235d0196e87b6d2a929e16533032d54599cf257b"},{"author":{"_account_id":13252,"name":"Dr. Jens Harbott","display_name":"Jens Harbott (frickler)","email":"frickler@offenerstapel.de","username":"jrosenboom"},"change_message_id":"945d06ca02e791ed8d6b58952219383f21b7b93d","unresolved":true,"context_lines":[{"line_number":37,"context_line":"Recordsets in Designate"},{"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"},{"line_number":39,"context_line":""},{"line_number":40,"context_line":"DNS records in Designate are managed using ``Recordsets``, which represent one"},{"line_number":41,"context_line":"or more DNS records with the same Name and Type, but potentially different"},{"line_number":42,"context_line":"data. For example, we could have the name ``www.example.com`` and the type"},{"line_number":43,"context_line":"``A`` with data of ``192.0.2.1`` and ``192.0.2.2`` which in reality might mean"}],"source_content_type":"text/x-rst","patch_set":6,"id":"df9f71d2_539d7eb2","line":40,"updated":"2021-05-20 15:26:59.000000000","message":"I\u0027m unsure about the use of capitalization here and in what follows, maybe because I\u0027m not a native speaker, but IMO you should either consistently capitalize a word everywhere you use it, or not at all.","commit_id":"235d0196e87b6d2a929e16533032d54599cf257b"},{"author":{"_account_id":6994,"name":"Michael Chapman","email":"woppin@gmail.com","username":"michaeltchapman"},"change_message_id":"9bd9e85b935f2b9a395f6dfeb2809dbf1724b35b","unresolved":false,"context_lines":[{"line_number":37,"context_line":"Recordsets in Designate"},{"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"},{"line_number":39,"context_line":""},{"line_number":40,"context_line":"DNS records in Designate are managed using ``Recordsets``, which represent one"},{"line_number":41,"context_line":"or more DNS records with the same Name and Type, but potentially different"},{"line_number":42,"context_line":"data. For example, we could have the name ``www.example.com`` and the type"},{"line_number":43,"context_line":"``A`` with data of ``192.0.2.1`` and ``192.0.2.2`` which in reality might mean"}],"source_content_type":"text/x-rst","patch_set":6,"id":"8cca82fa_4456a13a","line":40,"in_reply_to":"df9f71d2_539d7eb2","updated":"2021-05-26 14:16:32.000000000","message":"I missed this one, thanks.","commit_id":"235d0196e87b6d2a929e16533032d54599cf257b"},{"author":{"_account_id":13252,"name":"Dr. Jens Harbott","display_name":"Jens Harbott (frickler)","email":"frickler@offenerstapel.de","username":"jrosenboom"},"change_message_id":"945d06ca02e791ed8d6b58952219383f21b7b93d","unresolved":true,"context_lines":[{"line_number":39,"context_line":""},{"line_number":40,"context_line":"DNS records in Designate are managed using ``Recordsets``, which represent one"},{"line_number":41,"context_line":"or more DNS records with the same Name and Type, but potentially different"},{"line_number":42,"context_line":"data. For example, we could have the name ``www.example.com`` and the type"},{"line_number":43,"context_line":"``A`` with data of ``192.0.2.1`` and ``192.0.2.2`` which in reality might mean"},{"line_number":44,"context_line":"we have multiple servers hosting ``www.example.com`` located at those two"},{"line_number":45,"context_line":"IP addresses."}],"source_content_type":"text/x-rst","patch_set":6,"id":"c62d0a67_3dd8a66f","line":42,"range":{"start_line":42,"start_character":44,"end_line":42,"end_character":59},"updated":"2021-05-20 15:26:59.000000000","message":"Use \"www.example.org.\" here and below to be consistent with what the designate API+CLI expect? So .org consistently and always with trailing \".\"","commit_id":"235d0196e87b6d2a929e16533032d54599cf257b"},{"author":{"_account_id":6994,"name":"Michael Chapman","email":"woppin@gmail.com","username":"michaeltchapman"},"change_message_id":"9bd9e85b935f2b9a395f6dfeb2809dbf1724b35b","unresolved":false,"context_lines":[{"line_number":39,"context_line":""},{"line_number":40,"context_line":"DNS records in Designate are managed using ``Recordsets``, which represent one"},{"line_number":41,"context_line":"or more DNS records with the same Name and Type, but potentially different"},{"line_number":42,"context_line":"data. For example, we could have the name ``www.example.com`` and the type"},{"line_number":43,"context_line":"``A`` with data of ``192.0.2.1`` and ``192.0.2.2`` which in reality might mean"},{"line_number":44,"context_line":"we have multiple servers hosting ``www.example.com`` located at those two"},{"line_number":45,"context_line":"IP addresses."}],"source_content_type":"text/x-rst","patch_set":6,"id":"23754ff5_02a371e5","line":42,"range":{"start_line":42,"start_character":44,"end_line":42,"end_character":59},"in_reply_to":"c62d0a67_3dd8a66f","updated":"2021-05-26 14:16:32.000000000","message":"Done","commit_id":"235d0196e87b6d2a929e16533032d54599cf257b"},{"author":{"_account_id":13252,"name":"Dr. Jens Harbott","display_name":"Jens Harbott (frickler)","email":"frickler@offenerstapel.de","username":"jrosenboom"},"change_message_id":"945d06ca02e791ed8d6b58952219383f21b7b93d","unresolved":true,"context_lines":[{"line_number":44,"context_line":"we have multiple servers hosting ``www.example.com`` located at those two"},{"line_number":45,"context_line":"IP addresses."},{"line_number":46,"context_line":""},{"line_number":47,"context_line":"Recordsets must be created within a zone, and if a zone with recordsets is"},{"line_number":48,"context_line":"deleted, those recordsets will also be deleted."},{"line_number":49,"context_line":""},{"line_number":50,"context_line":"Creating a recordset"}],"source_content_type":"text/x-rst","patch_set":6,"id":"0154354e_e555ff26","line":47,"range":{"start_line":47,"start_character":56,"end_line":47,"end_character":60},"updated":"2021-05-20 15:26:59.000000000","message":"containing?","commit_id":"235d0196e87b6d2a929e16533032d54599cf257b"},{"author":{"_account_id":6994,"name":"Michael Chapman","email":"woppin@gmail.com","username":"michaeltchapman"},"change_message_id":"9bd9e85b935f2b9a395f6dfeb2809dbf1724b35b","unresolved":false,"context_lines":[{"line_number":44,"context_line":"we have multiple servers hosting ``www.example.com`` located at those two"},{"line_number":45,"context_line":"IP addresses."},{"line_number":46,"context_line":""},{"line_number":47,"context_line":"Recordsets must be created within a zone, and if a zone with recordsets is"},{"line_number":48,"context_line":"deleted, those recordsets will also be deleted."},{"line_number":49,"context_line":""},{"line_number":50,"context_line":"Creating a recordset"}],"source_content_type":"text/x-rst","patch_set":6,"id":"212331b4_b2410424","line":47,"range":{"start_line":47,"start_character":56,"end_line":47,"end_character":60},"in_reply_to":"0154354e_e555ff26","updated":"2021-05-26 14:16:32.000000000","message":"Done","commit_id":"235d0196e87b6d2a929e16533032d54599cf257b"},{"author":{"_account_id":13252,"name":"Dr. Jens Harbott","display_name":"Jens Harbott (frickler)","email":"frickler@offenerstapel.de","username":"jrosenboom"},"change_message_id":"945d06ca02e791ed8d6b58952219383f21b7b93d","unresolved":true,"context_lines":[{"line_number":114,"context_line":"      | zone_name   | example.org.                         |"},{"line_number":115,"context_line":"      +-------------+--------------------------------------+"},{"line_number":116,"context_line":""},{"line_number":117,"context_line":"The recordsets for a zone can be seen using a list command:"},{"line_number":118,"context_line":""},{"line_number":119,"context_line":"   .. code-block:: console"},{"line_number":120,"context_line":""}],"source_content_type":"text/x-rst","patch_set":6,"id":"4aff4e26_966a6930","line":117,"range":{"start_line":117,"start_character":44,"end_line":117,"end_character":45},"updated":"2021-05-20 15:26:59.000000000","message":"the?","commit_id":"235d0196e87b6d2a929e16533032d54599cf257b"},{"author":{"_account_id":6994,"name":"Michael Chapman","email":"woppin@gmail.com","username":"michaeltchapman"},"change_message_id":"9bd9e85b935f2b9a395f6dfeb2809dbf1724b35b","unresolved":false,"context_lines":[{"line_number":114,"context_line":"      | zone_name   | example.org.                         |"},{"line_number":115,"context_line":"      +-------------+--------------------------------------+"},{"line_number":116,"context_line":""},{"line_number":117,"context_line":"The recordsets for a zone can be seen using a list command:"},{"line_number":118,"context_line":""},{"line_number":119,"context_line":"   .. code-block:: console"},{"line_number":120,"context_line":""}],"source_content_type":"text/x-rst","patch_set":6,"id":"6835a475_ca7202ed","line":117,"range":{"start_line":117,"start_character":44,"end_line":117,"end_character":45},"in_reply_to":"4aff4e26_966a6930","updated":"2021-05-26 14:16:32.000000000","message":"Done","commit_id":"235d0196e87b6d2a929e16533032d54599cf257b"},{"author":{"_account_id":13252,"name":"Dr. Jens Harbott","display_name":"Jens Harbott (frickler)","email":"frickler@offenerstapel.de","username":"jrosenboom"},"change_message_id":"945d06ca02e791ed8d6b58952219383f21b7b93d","unresolved":true,"context_lines":[{"line_number":118,"context_line":""},{"line_number":119,"context_line":"   .. code-block:: console"},{"line_number":120,"context_line":""},{"line_number":121,"context_line":"       [root@devstack python-designateclient]# openstack recordset list example.org."},{"line_number":122,"context_line":"       +--------------------------------------+------------------+------+---------------------------------------------------------------------+--------+--------+"},{"line_number":123,"context_line":"       | id                                   | name             | type | records                                                             | status | action |"},{"line_number":124,"context_line":"       +--------------------------------------+------------------+------+---------------------------------------------------------------------+--------+--------+"}],"source_content_type":"text/x-rst","patch_set":6,"id":"7b120c04_affd2911","line":121,"range":{"start_line":121,"start_character":7,"end_line":121,"end_character":46},"updated":"2021-05-20 15:26:59.000000000","message":"Using root in devstack (or almost anywhere) seems like a bad example, just use \"$\" as prompt indicator?","commit_id":"235d0196e87b6d2a929e16533032d54599cf257b"},{"author":{"_account_id":6994,"name":"Michael Chapman","email":"woppin@gmail.com","username":"michaeltchapman"},"change_message_id":"9bd9e85b935f2b9a395f6dfeb2809dbf1724b35b","unresolved":false,"context_lines":[{"line_number":118,"context_line":""},{"line_number":119,"context_line":"   .. code-block:: console"},{"line_number":120,"context_line":""},{"line_number":121,"context_line":"       [root@devstack python-designateclient]# openstack recordset list example.org."},{"line_number":122,"context_line":"       +--------------------------------------+------------------+------+---------------------------------------------------------------------+--------+--------+"},{"line_number":123,"context_line":"       | id                                   | name             | type | records                                                             | status | action |"},{"line_number":124,"context_line":"       +--------------------------------------+------------------+------+---------------------------------------------------------------------+--------+--------+"}],"source_content_type":"text/x-rst","patch_set":6,"id":"3eff1c33_a116d99a","line":121,"range":{"start_line":121,"start_character":7,"end_line":121,"end_character":46},"in_reply_to":"7b120c04_affd2911","updated":"2021-05-26 14:16:32.000000000","message":"Done","commit_id":"235d0196e87b6d2a929e16533032d54599cf257b"},{"author":{"_account_id":13252,"name":"Dr. Jens Harbott","display_name":"Jens Harbott (frickler)","email":"frickler@offenerstapel.de","username":"jrosenboom"},"change_message_id":"945d06ca02e791ed8d6b58952219383f21b7b93d","unresolved":true,"context_lines":[{"line_number":132,"context_line":"The ``SOA`` and ``NS`` records for the zone are also visible here, but cannot"},{"line_number":133,"context_line":"be modified by regular users. Users with the admin role can modify these"},{"line_number":134,"context_line":"records with the ``--edit-managed`` option, though this is not likely to be a"},{"line_number":135,"context_line":"common operation."},{"line_number":136,"context_line":""},{"line_number":137,"context_line":"If its address is known, the results can be verified by querying the backend"},{"line_number":138,"context_line":"nameserver, which in this example is at 203.0.113.100:"}],"source_content_type":"text/x-rst","patch_set":6,"id":"d8ee7593_7985d003","line":135,"updated":"2021-05-20 15:26:59.000000000","message":"Did you check that one actually can change the NS record? If yes, that would be a bug to me, because it would break the name server from being authoritative for this zone. IMO this should either be amended with a warning or removed because it\u0027s not relevant for a normal user.","commit_id":"235d0196e87b6d2a929e16533032d54599cf257b"},{"author":{"_account_id":6994,"name":"Michael Chapman","email":"woppin@gmail.com","username":"michaeltchapman"},"change_message_id":"9bd9e85b935f2b9a395f6dfeb2809dbf1724b35b","unresolved":true,"context_lines":[{"line_number":132,"context_line":"The ``SOA`` and ``NS`` records for the zone are also visible here, but cannot"},{"line_number":133,"context_line":"be modified by regular users. Users with the admin role can modify these"},{"line_number":134,"context_line":"records with the ``--edit-managed`` option, though this is not likely to be a"},{"line_number":135,"context_line":"common operation."},{"line_number":136,"context_line":""},{"line_number":137,"context_line":"If its address is known, the results can be verified by querying the backend"},{"line_number":138,"context_line":"nameserver, which in this example is at 203.0.113.100:"}],"source_content_type":"text/x-rst","patch_set":6,"id":"965c2a92_f6944635","line":135,"in_reply_to":"d8ee7593_7985d003","updated":"2021-05-26 14:16:32.000000000","message":"After testing, I can\u0027t modify either NS or SOA in any way even with --edit-managed and admin credentials so i\"ll remove this. What is --edit-managed for if not this?","commit_id":"235d0196e87b6d2a929e16533032d54599cf257b"},{"author":{"_account_id":13252,"name":"Dr. Jens Harbott","display_name":"Jens Harbott (frickler)","email":"frickler@offenerstapel.de","username":"jrosenboom"},"change_message_id":"945d06ca02e791ed8d6b58952219383f21b7b93d","unresolved":true,"context_lines":[{"line_number":134,"context_line":"records with the ``--edit-managed`` option, though this is not likely to be a"},{"line_number":135,"context_line":"common operation."},{"line_number":136,"context_line":""},{"line_number":137,"context_line":"If its address is known, the results can be verified by querying the backend"},{"line_number":138,"context_line":"nameserver, which in this example is at 203.0.113.100:"},{"line_number":139,"context_line":""},{"line_number":140,"context_line":"   .. code-block:: console"}],"source_content_type":"text/x-rst","patch_set":6,"id":"db06fb87_2bed251e","line":137,"range":{"start_line":137,"start_character":0,"end_line":137,"end_character":23},"updated":"2021-05-20 15:26:59.000000000","message":"Shouldn\u0027t one in general be able to simply use the nameserver listed in the SOA/NS records, like ns1.example.net in this case? That would be assuming a working installation of course, not a demo installation with fake data.","commit_id":"235d0196e87b6d2a929e16533032d54599cf257b"},{"author":{"_account_id":6994,"name":"Michael Chapman","email":"woppin@gmail.com","username":"michaeltchapman"},"change_message_id":"9bd9e85b935f2b9a395f6dfeb2809dbf1724b35b","unresolved":false,"context_lines":[{"line_number":134,"context_line":"records with the ``--edit-managed`` option, though this is not likely to be a"},{"line_number":135,"context_line":"common operation."},{"line_number":136,"context_line":""},{"line_number":137,"context_line":"If its address is known, the results can be verified by querying the backend"},{"line_number":138,"context_line":"nameserver, which in this example is at 203.0.113.100:"},{"line_number":139,"context_line":""},{"line_number":140,"context_line":"   .. code-block:: console"}],"source_content_type":"text/x-rst","patch_set":6,"id":"4d9a037b_724e4eda","line":137,"range":{"start_line":137,"start_character":0,"end_line":137,"end_character":23},"in_reply_to":"db06fb87_2bed251e","updated":"2021-05-26 14:16:32.000000000","message":"Done","commit_id":"235d0196e87b6d2a929e16533032d54599cf257b"},{"author":{"_account_id":13252,"name":"Dr. Jens Harbott","display_name":"Jens Harbott (frickler)","email":"frickler@offenerstapel.de","username":"jrosenboom"},"change_message_id":"945d06ca02e791ed8d6b58952219383f21b7b93d","unresolved":true,"context_lines":[{"line_number":195,"context_line":"of the IPs for the webservers, which doesn\u0027t exactly match the initial"},{"line_number":196,"context_line":"requirements set out. Instead of creating the second recordset, it is possible"},{"line_number":197,"context_line":"to update a recordset to add or remove records instead of needing to create"},{"line_number":198,"context_line":"new ones:"},{"line_number":199,"context_line":""},{"line_number":200,"context_line":"   .. code-block:: console"},{"line_number":201,"context_line":""}],"source_content_type":"text/x-rst","patch_set":6,"id":"24192f22_731ea160","line":198,"range":{"start_line":198,"start_character":0,"end_line":198,"end_character":8},"updated":"2021-05-20 15:26:59.000000000","message":"This whole paragraph is confusing. As you mention earlier, it wouldn\u0027t be possible to create a second recordset for the same name and type unless one first deletes the original one. Also the previous example does create a recordset with two records, so you are rather referring to the first example, aren\u0027t you?","commit_id":"235d0196e87b6d2a929e16533032d54599cf257b"},{"author":{"_account_id":6994,"name":"Michael Chapman","email":"woppin@gmail.com","username":"michaeltchapman"},"change_message_id":"9bd9e85b935f2b9a395f6dfeb2809dbf1724b35b","unresolved":false,"context_lines":[{"line_number":195,"context_line":"of the IPs for the webservers, which doesn\u0027t exactly match the initial"},{"line_number":196,"context_line":"requirements set out. Instead of creating the second recordset, it is possible"},{"line_number":197,"context_line":"to update a recordset to add or remove records instead of needing to create"},{"line_number":198,"context_line":"new ones:"},{"line_number":199,"context_line":""},{"line_number":200,"context_line":"   .. code-block:: console"},{"line_number":201,"context_line":""}],"source_content_type":"text/x-rst","patch_set":6,"id":"ff0faf1c_0c9494c7","line":198,"range":{"start_line":198,"start_character":0,"end_line":198,"end_character":8},"in_reply_to":"24192f22_731ea160","updated":"2021-05-26 14:16:32.000000000","message":"Done","commit_id":"235d0196e87b6d2a929e16533032d54599cf257b"},{"author":{"_account_id":13252,"name":"Dr. Jens Harbott","display_name":"Jens Harbott (frickler)","email":"frickler@offenerstapel.de","username":"jrosenboom"},"change_message_id":"945d06ca02e791ed8d6b58952219383f21b7b93d","unresolved":true,"context_lines":[{"line_number":221,"context_line":"       +-------------+--------------------------------------+"},{"line_number":222,"context_line":""},{"line_number":223,"context_line":"In contrast to recordset creation, the FQDN must be used when updating a"},{"line_number":224,"context_line":"recordset by name. As with most Openstack operations, the ID can also"},{"line_number":225,"context_line":"be used."},{"line_number":226,"context_line":""},{"line_number":227,"context_line":"Deleting a recordset"}],"source_content_type":"text/x-rst","patch_set":6,"id":"9d4ba883_e77f6807","line":224,"range":{"start_line":224,"start_character":32,"end_line":224,"end_character":41},"updated":"2021-05-20 15:26:59.000000000","message":"OpenStack","commit_id":"235d0196e87b6d2a929e16533032d54599cf257b"},{"author":{"_account_id":6994,"name":"Michael Chapman","email":"woppin@gmail.com","username":"michaeltchapman"},"change_message_id":"9bd9e85b935f2b9a395f6dfeb2809dbf1724b35b","unresolved":false,"context_lines":[{"line_number":221,"context_line":"       +-------------+--------------------------------------+"},{"line_number":222,"context_line":""},{"line_number":223,"context_line":"In contrast to recordset creation, the FQDN must be used when updating a"},{"line_number":224,"context_line":"recordset by name. As with most Openstack operations, the ID can also"},{"line_number":225,"context_line":"be used."},{"line_number":226,"context_line":""},{"line_number":227,"context_line":"Deleting a recordset"}],"source_content_type":"text/x-rst","patch_set":6,"id":"87213f1f_09fe84b2","line":224,"range":{"start_line":224,"start_character":32,"end_line":224,"end_character":41},"in_reply_to":"9d4ba883_e77f6807","updated":"2021-05-26 14:16:32.000000000","message":"Done","commit_id":"235d0196e87b6d2a929e16533032d54599cf257b"},{"author":{"_account_id":31933,"name":"Greg Rakauskas","display_name":"Greg Rakauskas","email":"gregraka@redhat.com","username":"gregraka"},"change_message_id":"b7c684d5f51a211d5f5b644ac528e4f013386a3f","unresolved":true,"context_lines":[{"line_number":22,"context_line":"\u0027resource records\u0027, or simply \u0027records\u0027, are used to store data within the"},{"line_number":23,"context_line":"namespace. Each record has a:"},{"line_number":24,"context_line":""},{"line_number":25,"context_line":"- **Name** that indicates its location in the DNS namespace;"},{"line_number":26,"context_line":"- **Type** that describes what sort of record this is, for example an ``MX``"},{"line_number":27,"context_line":"  record used for mail delivery or an ``NS`` record used for zone delegation;"},{"line_number":28,"context_line":"- **Class** which is most frequently set to ``IN`` for internet;"}],"source_content_type":"text/x-rst","patch_set":7,"id":"7fb51909_622ee94c","line":25,"range":{"start_line":25,"start_character":2,"end_line":25,"end_character":10},"updated":"2021-05-27 22:21:28.000000000","message":"It might be helpful to identify what ``Name`` is? (A string? A number? Something else?)\n\nAlso, it will help this list to be in parallel with the other list items that follow. For example:\n\n  - ``Type`` the set of letter codes that...\n  - ``Class`` the set of letter codes that...\n  - ``TTL`` the duration (in seconds) that...","commit_id":"8bd479ec82b433a1423cb0e97dec409775fd0efd"},{"author":{"_account_id":6994,"name":"Michael Chapman","email":"woppin@gmail.com","username":"michaeltchapman"},"change_message_id":"b7e4cd75c9e6a0b84ff21681f73eee47daabf965","unresolved":false,"context_lines":[{"line_number":22,"context_line":"\u0027resource records\u0027, or simply \u0027records\u0027, are used to store data within the"},{"line_number":23,"context_line":"namespace. Each record has a:"},{"line_number":24,"context_line":""},{"line_number":25,"context_line":"- **Name** that indicates its location in the DNS namespace;"},{"line_number":26,"context_line":"- **Type** that describes what sort of record this is, for example an ``MX``"},{"line_number":27,"context_line":"  record used for mail delivery or an ``NS`` record used for zone delegation;"},{"line_number":28,"context_line":"- **Class** which is most frequently set to ``IN`` for internet;"}],"source_content_type":"text/x-rst","patch_set":7,"id":"68c18589_1fac2e07","line":25,"range":{"start_line":25,"start_character":2,"end_line":25,"end_character":10},"in_reply_to":"7fb51909_622ee94c","updated":"2021-06-08 02:23:16.000000000","message":"Done","commit_id":"8bd479ec82b433a1423cb0e97dec409775fd0efd"},{"author":{"_account_id":31933,"name":"Greg Rakauskas","display_name":"Greg Rakauskas","email":"gregraka@redhat.com","username":"gregraka"},"change_message_id":"b7c684d5f51a211d5f5b644ac528e4f013386a3f","unresolved":true,"context_lines":[{"line_number":23,"context_line":"namespace. Each record has a:"},{"line_number":24,"context_line":""},{"line_number":25,"context_line":"- **Name** that indicates its location in the DNS namespace;"},{"line_number":26,"context_line":"- **Type** that describes what sort of record this is, for example an ``MX``"},{"line_number":27,"context_line":"  record used for mail delivery or an ``NS`` record used for zone delegation;"},{"line_number":28,"context_line":"- **Class** which is most frequently set to ``IN`` for internet;"},{"line_number":29,"context_line":"- **TTL** duration in seconds that the record will remain valid;"}],"source_content_type":"text/x-rst","patch_set":7,"id":"12aeeea6_758a20b9","line":26,"range":{"start_line":26,"start_character":2,"end_line":26,"end_character":10},"updated":"2021-05-27 22:21:28.000000000","message":"Suggestion: reword to something like:\n\n\"`Type`` the set of letter codes that identify the record\u0027s usage. For example, ``MX`` indicates mail delivery records. For the list of record type letter codes, see the links later in this topic;\"","commit_id":"8bd479ec82b433a1423cb0e97dec409775fd0efd"},{"author":{"_account_id":6994,"name":"Michael Chapman","email":"woppin@gmail.com","username":"michaeltchapman"},"change_message_id":"b7e4cd75c9e6a0b84ff21681f73eee47daabf965","unresolved":false,"context_lines":[{"line_number":23,"context_line":"namespace. Each record has a:"},{"line_number":24,"context_line":""},{"line_number":25,"context_line":"- **Name** that indicates its location in the DNS namespace;"},{"line_number":26,"context_line":"- **Type** that describes what sort of record this is, for example an ``MX``"},{"line_number":27,"context_line":"  record used for mail delivery or an ``NS`` record used for zone delegation;"},{"line_number":28,"context_line":"- **Class** which is most frequently set to ``IN`` for internet;"},{"line_number":29,"context_line":"- **TTL** duration in seconds that the record will remain valid;"}],"source_content_type":"text/x-rst","patch_set":7,"id":"b4c88add_40e39b2c","line":26,"range":{"start_line":26,"start_character":2,"end_line":26,"end_character":10},"in_reply_to":"12aeeea6_758a20b9","updated":"2021-06-08 02:23:16.000000000","message":"Done","commit_id":"8bd479ec82b433a1423cb0e97dec409775fd0efd"},{"author":{"_account_id":31933,"name":"Greg Rakauskas","display_name":"Greg Rakauskas","email":"gregraka@redhat.com","username":"gregraka"},"change_message_id":"b7c684d5f51a211d5f5b644ac528e4f013386a3f","unresolved":true,"context_lines":[{"line_number":25,"context_line":"- **Name** that indicates its location in the DNS namespace;"},{"line_number":26,"context_line":"- **Type** that describes what sort of record this is, for example an ``MX``"},{"line_number":27,"context_line":"  record used for mail delivery or an ``NS`` record used for zone delegation;"},{"line_number":28,"context_line":"- **Class** which is most frequently set to ``IN`` for internet;"},{"line_number":29,"context_line":"- **TTL** duration in seconds that the record will remain valid;"},{"line_number":30,"context_line":"- **Rdata** which contains any data for the record, such as an IP address"},{"line_number":31,"context_line":"  for an ``A`` type record or another record name for a ``CNAME`` type record."}],"source_content_type":"text/x-rst","patch_set":7,"id":"36c82479_f5e71fd1","line":28,"range":{"start_line":28,"start_character":2,"end_line":28,"end_character":11},"updated":"2021-05-27 22:21:28.000000000","message":"Perhaps reword to read?\n\n\"``Class`` the set of letter codes that specifies the category for the record. Typically, this is ``IN`` for internet. For the list of record class letter codes, see the links later in this topic;\"","commit_id":"8bd479ec82b433a1423cb0e97dec409775fd0efd"},{"author":{"_account_id":6994,"name":"Michael Chapman","email":"woppin@gmail.com","username":"michaeltchapman"},"change_message_id":"b7e4cd75c9e6a0b84ff21681f73eee47daabf965","unresolved":false,"context_lines":[{"line_number":25,"context_line":"- **Name** that indicates its location in the DNS namespace;"},{"line_number":26,"context_line":"- **Type** that describes what sort of record this is, for example an ``MX``"},{"line_number":27,"context_line":"  record used for mail delivery or an ``NS`` record used for zone delegation;"},{"line_number":28,"context_line":"- **Class** which is most frequently set to ``IN`` for internet;"},{"line_number":29,"context_line":"- **TTL** duration in seconds that the record will remain valid;"},{"line_number":30,"context_line":"- **Rdata** which contains any data for the record, such as an IP address"},{"line_number":31,"context_line":"  for an ``A`` type record or another record name for a ``CNAME`` type record."}],"source_content_type":"text/x-rst","patch_set":7,"id":"fd02328b_8d85acef","line":28,"range":{"start_line":28,"start_character":2,"end_line":28,"end_character":11},"in_reply_to":"36c82479_f5e71fd1","updated":"2021-06-08 02:23:16.000000000","message":"I don\u0027t think it\u0027s worth mentioning the other classes.","commit_id":"8bd479ec82b433a1423cb0e97dec409775fd0efd"},{"author":{"_account_id":31933,"name":"Greg Rakauskas","display_name":"Greg Rakauskas","email":"gregraka@redhat.com","username":"gregraka"},"change_message_id":"b7c684d5f51a211d5f5b644ac528e4f013386a3f","unresolved":true,"context_lines":[{"line_number":26,"context_line":"- **Type** that describes what sort of record this is, for example an ``MX``"},{"line_number":27,"context_line":"  record used for mail delivery or an ``NS`` record used for zone delegation;"},{"line_number":28,"context_line":"- **Class** which is most frequently set to ``IN`` for internet;"},{"line_number":29,"context_line":"- **TTL** duration in seconds that the record will remain valid;"},{"line_number":30,"context_line":"- **Rdata** which contains any data for the record, such as an IP address"},{"line_number":31,"context_line":"  for an ``A`` type record or another record name for a ``CNAME`` type record."},{"line_number":32,"context_line":""}],"source_content_type":"text/x-rst","patch_set":7,"id":"c8e5ddb2_88c7d907","line":29,"range":{"start_line":29,"start_character":2,"end_line":29,"end_character":9},"updated":"2021-05-27 22:21:28.000000000","message":"Suggest:\n\nadd \"the\" to keep list items in parallel: \n\n   \"``TTL`` the duration (in seconds) that the record remains valid.\"","commit_id":"8bd479ec82b433a1423cb0e97dec409775fd0efd"},{"author":{"_account_id":31933,"name":"Greg Rakauskas","display_name":"Greg Rakauskas","email":"gregraka@redhat.com","username":"gregraka"},"change_message_id":"b7c684d5f51a211d5f5b644ac528e4f013386a3f","unresolved":true,"context_lines":[{"line_number":26,"context_line":"- **Type** that describes what sort of record this is, for example an ``MX``"},{"line_number":27,"context_line":"  record used for mail delivery or an ``NS`` record used for zone delegation;"},{"line_number":28,"context_line":"- **Class** which is most frequently set to ``IN`` for internet;"},{"line_number":29,"context_line":"- **TTL** duration in seconds that the record will remain valid;"},{"line_number":30,"context_line":"- **Rdata** which contains any data for the record, such as an IP address"},{"line_number":31,"context_line":"  for an ``A`` type record or another record name for a ``CNAME`` type record."},{"line_number":32,"context_line":""}],"source_content_type":"text/x-rst","patch_set":7,"id":"2634f271_dbe88682","line":29,"range":{"start_line":29,"start_character":46,"end_line":29,"end_character":50},"updated":"2021-05-27 22:21:28.000000000","message":"Suggestion: try to avoid future tense when possible.","commit_id":"8bd479ec82b433a1423cb0e97dec409775fd0efd"},{"author":{"_account_id":6994,"name":"Michael Chapman","email":"woppin@gmail.com","username":"michaeltchapman"},"change_message_id":"b7e4cd75c9e6a0b84ff21681f73eee47daabf965","unresolved":false,"context_lines":[{"line_number":26,"context_line":"- **Type** that describes what sort of record this is, for example an ``MX``"},{"line_number":27,"context_line":"  record used for mail delivery or an ``NS`` record used for zone delegation;"},{"line_number":28,"context_line":"- **Class** which is most frequently set to ``IN`` for internet;"},{"line_number":29,"context_line":"- **TTL** duration in seconds that the record will remain valid;"},{"line_number":30,"context_line":"- **Rdata** which contains any data for the record, such as an IP address"},{"line_number":31,"context_line":"  for an ``A`` type record or another record name for a ``CNAME`` type record."},{"line_number":32,"context_line":""}],"source_content_type":"text/x-rst","patch_set":7,"id":"1f57b6c6_b07b1e17","line":29,"range":{"start_line":29,"start_character":46,"end_line":29,"end_character":50},"in_reply_to":"2634f271_dbe88682","updated":"2021-06-08 02:23:16.000000000","message":"Done","commit_id":"8bd479ec82b433a1423cb0e97dec409775fd0efd"},{"author":{"_account_id":6994,"name":"Michael Chapman","email":"woppin@gmail.com","username":"michaeltchapman"},"change_message_id":"b7e4cd75c9e6a0b84ff21681f73eee47daabf965","unresolved":false,"context_lines":[{"line_number":26,"context_line":"- **Type** that describes what sort of record this is, for example an ``MX``"},{"line_number":27,"context_line":"  record used for mail delivery or an ``NS`` record used for zone delegation;"},{"line_number":28,"context_line":"- **Class** which is most frequently set to ``IN`` for internet;"},{"line_number":29,"context_line":"- **TTL** duration in seconds that the record will remain valid;"},{"line_number":30,"context_line":"- **Rdata** which contains any data for the record, such as an IP address"},{"line_number":31,"context_line":"  for an ``A`` type record or another record name for a ``CNAME`` type record."},{"line_number":32,"context_line":""}],"source_content_type":"text/x-rst","patch_set":7,"id":"4c23d360_c076bf60","line":29,"range":{"start_line":29,"start_character":2,"end_line":29,"end_character":9},"in_reply_to":"c8e5ddb2_88c7d907","updated":"2021-06-08 02:23:16.000000000","message":"Done","commit_id":"8bd479ec82b433a1423cb0e97dec409775fd0efd"},{"author":{"_account_id":31933,"name":"Greg Rakauskas","display_name":"Greg Rakauskas","email":"gregraka@redhat.com","username":"gregraka"},"change_message_id":"b7c684d5f51a211d5f5b644ac528e4f013386a3f","unresolved":true,"context_lines":[{"line_number":27,"context_line":"  record used for mail delivery or an ``NS`` record used for zone delegation;"},{"line_number":28,"context_line":"- **Class** which is most frequently set to ``IN`` for internet;"},{"line_number":29,"context_line":"- **TTL** duration in seconds that the record will remain valid;"},{"line_number":30,"context_line":"- **Rdata** which contains any data for the record, such as an IP address"},{"line_number":31,"context_line":"  for an ``A`` type record or another record name for a ``CNAME`` type record."},{"line_number":32,"context_line":""},{"line_number":33,"context_line":"More information about records and the different types available can be found"}],"source_content_type":"text/x-rst","patch_set":7,"id":"4d949a73_bbc2dd90","line":30,"range":{"start_line":30,"start_character":2,"end_line":30,"end_character":11},"updated":"2021-05-27 22:21:28.000000000","message":"Suggest that you change to keep this item in parallel w/ the others:\n\n   \"``Rdata`` the data for the record. For example, an IP address for an ``A`` type record, or a second record name for a ``CNAME`` type record.\"","commit_id":"8bd479ec82b433a1423cb0e97dec409775fd0efd"},{"author":{"_account_id":6994,"name":"Michael Chapman","email":"woppin@gmail.com","username":"michaeltchapman"},"change_message_id":"b7e4cd75c9e6a0b84ff21681f73eee47daabf965","unresolved":false,"context_lines":[{"line_number":27,"context_line":"  record used for mail delivery or an ``NS`` record used for zone delegation;"},{"line_number":28,"context_line":"- **Class** which is most frequently set to ``IN`` for internet;"},{"line_number":29,"context_line":"- **TTL** duration in seconds that the record will remain valid;"},{"line_number":30,"context_line":"- **Rdata** which contains any data for the record, such as an IP address"},{"line_number":31,"context_line":"  for an ``A`` type record or another record name for a ``CNAME`` type record."},{"line_number":32,"context_line":""},{"line_number":33,"context_line":"More information about records and the different types available can be found"}],"source_content_type":"text/x-rst","patch_set":7,"id":"221946e7_f653bbb5","line":30,"range":{"start_line":30,"start_character":2,"end_line":30,"end_character":11},"in_reply_to":"4d949a73_bbc2dd90","updated":"2021-06-08 02:23:16.000000000","message":"Done","commit_id":"8bd479ec82b433a1423cb0e97dec409775fd0efd"},{"author":{"_account_id":31933,"name":"Greg Rakauskas","display_name":"Greg Rakauskas","email":"gregraka@redhat.com","username":"gregraka"},"change_message_id":"b7c684d5f51a211d5f5b644ac528e4f013386a3f","unresolved":true,"context_lines":[{"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"},{"line_number":39,"context_line":""},{"line_number":40,"context_line":"DNS records in Designate are managed using ``Recordsets``, which represent one"},{"line_number":41,"context_line":"or more DNS records with the same Name and Type, but potentially different"},{"line_number":42,"context_line":"data. For example, we could have the name ``www.example.org.`` and the type"},{"line_number":43,"context_line":"``A`` with data of ``192.0.2.1`` and ``192.0.2.2`` which in reality might mean"},{"line_number":44,"context_line":"we have multiple servers hosting ``www.example.org.`` located at those two"}],"source_content_type":"text/x-rst","patch_set":7,"id":"0cc74342_25b9b6bf","line":41,"range":{"start_line":41,"start_character":34,"end_line":41,"end_character":47},"updated":"2021-05-27 22:21:28.000000000","message":"Nit: if you are referring to the literal variables `Name` and `Type,` capitalize them and use back ticks. Alternatively, (IMHO) it\u0027s fine to use all lowercase w/o back ticks. But, use one treatment or the other. :^)","commit_id":"8bd479ec82b433a1423cb0e97dec409775fd0efd"},{"author":{"_account_id":6994,"name":"Michael Chapman","email":"woppin@gmail.com","username":"michaeltchapman"},"change_message_id":"b7e4cd75c9e6a0b84ff21681f73eee47daabf965","unresolved":false,"context_lines":[{"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"},{"line_number":39,"context_line":""},{"line_number":40,"context_line":"DNS records in Designate are managed using ``Recordsets``, which represent one"},{"line_number":41,"context_line":"or more DNS records with the same Name and Type, but potentially different"},{"line_number":42,"context_line":"data. For example, we could have the name ``www.example.org.`` and the type"},{"line_number":43,"context_line":"``A`` with data of ``192.0.2.1`` and ``192.0.2.2`` which in reality might mean"},{"line_number":44,"context_line":"we have multiple servers hosting ``www.example.org.`` located at those two"}],"source_content_type":"text/x-rst","patch_set":7,"id":"a4e9e344_7e9dbafb","line":41,"range":{"start_line":41,"start_character":34,"end_line":41,"end_character":47},"in_reply_to":"0cc74342_25b9b6bf","updated":"2021-06-08 02:23:16.000000000","message":"Done","commit_id":"8bd479ec82b433a1423cb0e97dec409775fd0efd"},{"author":{"_account_id":31933,"name":"Greg Rakauskas","display_name":"Greg Rakauskas","email":"gregraka@redhat.com","username":"gregraka"},"change_message_id":"b7c684d5f51a211d5f5b644ac528e4f013386a3f","unresolved":true,"context_lines":[{"line_number":39,"context_line":""},{"line_number":40,"context_line":"DNS records in Designate are managed using ``Recordsets``, which represent one"},{"line_number":41,"context_line":"or more DNS records with the same Name and Type, but potentially different"},{"line_number":42,"context_line":"data. For example, we could have the name ``www.example.org.`` and the type"},{"line_number":43,"context_line":"``A`` with data of ``192.0.2.1`` and ``192.0.2.2`` which in reality might mean"},{"line_number":44,"context_line":"we have multiple servers hosting ``www.example.org.`` located at those two"},{"line_number":45,"context_line":"IP addresses."},{"line_number":46,"context_line":""},{"line_number":47,"context_line":"Recordsets must be created within a zone, and if a zone containing recordsets"},{"line_number":48,"context_line":"is deleted, those recordsets will also be deleted."}],"source_content_type":"text/x-rst","patch_set":7,"id":"6fcd27eb_91114094","line":45,"range":{"start_line":42,"start_character":6,"end_line":45,"end_character":13},"updated":"2021-05-27 22:21:28.000000000","message":"I would suggest this rewrite:\n\n\"For example, a recordset named ``www.example.com``, with a type of ``A``, that contains the data ``10.0.0.1`` and ``10.0.0.2`` might be two web servers hosting ``www.example.com`` located at those two IP addresses.\"","commit_id":"8bd479ec82b433a1423cb0e97dec409775fd0efd"},{"author":{"_account_id":6994,"name":"Michael Chapman","email":"woppin@gmail.com","username":"michaeltchapman"},"change_message_id":"b7e4cd75c9e6a0b84ff21681f73eee47daabf965","unresolved":false,"context_lines":[{"line_number":39,"context_line":""},{"line_number":40,"context_line":"DNS records in Designate are managed using ``Recordsets``, which represent one"},{"line_number":41,"context_line":"or more DNS records with the same Name and Type, but potentially different"},{"line_number":42,"context_line":"data. For example, we could have the name ``www.example.org.`` and the type"},{"line_number":43,"context_line":"``A`` with data of ``192.0.2.1`` and ``192.0.2.2`` which in reality might mean"},{"line_number":44,"context_line":"we have multiple servers hosting ``www.example.org.`` located at those two"},{"line_number":45,"context_line":"IP addresses."},{"line_number":46,"context_line":""},{"line_number":47,"context_line":"Recordsets must be created within a zone, and if a zone containing recordsets"},{"line_number":48,"context_line":"is deleted, those recordsets will also be deleted."}],"source_content_type":"text/x-rst","patch_set":7,"id":"8d673bb7_d94a1ada","line":45,"range":{"start_line":42,"start_character":6,"end_line":45,"end_character":13},"in_reply_to":"6fcd27eb_91114094","updated":"2021-06-08 02:23:16.000000000","message":"Done, but be -\u003e reflect (indicate?)","commit_id":"8bd479ec82b433a1423cb0e97dec409775fd0efd"},{"author":{"_account_id":31933,"name":"Greg Rakauskas","display_name":"Greg Rakauskas","email":"gregraka@redhat.com","username":"gregraka"},"change_message_id":"b7c684d5f51a211d5f5b644ac528e4f013386a3f","unresolved":true,"context_lines":[{"line_number":44,"context_line":"we have multiple servers hosting ``www.example.org.`` located at those two"},{"line_number":45,"context_line":"IP addresses."},{"line_number":46,"context_line":""},{"line_number":47,"context_line":"Recordsets must be created within a zone, and if a zone containing recordsets"},{"line_number":48,"context_line":"is deleted, those recordsets will also be deleted."},{"line_number":49,"context_line":""},{"line_number":50,"context_line":"Creating a recordset"},{"line_number":51,"context_line":"--------------------"}],"source_content_type":"text/x-rst","patch_set":7,"id":"05b5e097_f83afe6a","line":48,"range":{"start_line":47,"start_character":0,"end_line":48,"end_character":50},"updated":"2021-05-27 22:21:28.000000000","message":"Whenever possible, use active voice.\n\nSuggested change:\n\n   \"You must create Recordsets within a zone. If you delete a zone that contains recordsets, those recordsets within the zone are also deleted.\"","commit_id":"8bd479ec82b433a1423cb0e97dec409775fd0efd"},{"author":{"_account_id":6994,"name":"Michael Chapman","email":"woppin@gmail.com","username":"michaeltchapman"},"change_message_id":"b7e4cd75c9e6a0b84ff21681f73eee47daabf965","unresolved":false,"context_lines":[{"line_number":44,"context_line":"we have multiple servers hosting ``www.example.org.`` located at those two"},{"line_number":45,"context_line":"IP addresses."},{"line_number":46,"context_line":""},{"line_number":47,"context_line":"Recordsets must be created within a zone, and if a zone containing recordsets"},{"line_number":48,"context_line":"is deleted, those recordsets will also be deleted."},{"line_number":49,"context_line":""},{"line_number":50,"context_line":"Creating a recordset"},{"line_number":51,"context_line":"--------------------"}],"source_content_type":"text/x-rst","patch_set":7,"id":"fe9a76e5_0e321373","line":48,"range":{"start_line":47,"start_character":0,"end_line":48,"end_character":50},"in_reply_to":"05b5e097_f83afe6a","updated":"2021-06-08 02:23:16.000000000","message":"Done","commit_id":"8bd479ec82b433a1423cb0e97dec409775fd0efd"},{"author":{"_account_id":31933,"name":"Greg Rakauskas","display_name":"Greg Rakauskas","email":"gregraka@redhat.com","username":"gregraka"},"change_message_id":"b7c684d5f51a211d5f5b644ac528e4f013386a3f","unresolved":true,"context_lines":[{"line_number":50,"context_line":"Creating a recordset"},{"line_number":51,"context_line":"--------------------"},{"line_number":52,"context_line":""},{"line_number":53,"context_line":"By default, Recordsets can be created by any user in zones that are owned by"},{"line_number":54,"context_line":"their project. In this example it is assumed the user has already created"},{"line_number":55,"context_line":"a zone ``example.org.``."},{"line_number":56,"context_line":""},{"line_number":57,"context_line":"Recordsets are created using the ``openstack recordset create`` command and"},{"line_number":58,"context_line":"require a zone, a name, a type, and data for the record."}],"source_content_type":"text/x-rst","patch_set":7,"id":"140cc148_f28a23c4","line":55,"range":{"start_line":53,"start_character":0,"end_line":55,"end_character":24},"updated":"2021-05-27 22:21:28.000000000","message":"Suggest this change:\n\n\"By default, any user can create Recordsets in zones that their project owns. In this example, a user has created a zone named ``example.org.``.\"","commit_id":"8bd479ec82b433a1423cb0e97dec409775fd0efd"},{"author":{"_account_id":6994,"name":"Michael Chapman","email":"woppin@gmail.com","username":"michaeltchapman"},"change_message_id":"b7e4cd75c9e6a0b84ff21681f73eee47daabf965","unresolved":false,"context_lines":[{"line_number":50,"context_line":"Creating a recordset"},{"line_number":51,"context_line":"--------------------"},{"line_number":52,"context_line":""},{"line_number":53,"context_line":"By default, Recordsets can be created by any user in zones that are owned by"},{"line_number":54,"context_line":"their project. In this example it is assumed the user has already created"},{"line_number":55,"context_line":"a zone ``example.org.``."},{"line_number":56,"context_line":""},{"line_number":57,"context_line":"Recordsets are created using the ``openstack recordset create`` command and"},{"line_number":58,"context_line":"require a zone, a name, a type, and data for the record."}],"source_content_type":"text/x-rst","patch_set":7,"id":"530b6d57_46f55b20","line":55,"range":{"start_line":53,"start_character":0,"end_line":55,"end_character":24},"in_reply_to":"140cc148_f28a23c4","updated":"2021-06-08 02:23:16.000000000","message":"Done","commit_id":"8bd479ec82b433a1423cb0e97dec409775fd0efd"},{"author":{"_account_id":31933,"name":"Greg Rakauskas","display_name":"Greg Rakauskas","email":"gregraka@redhat.com","username":"gregraka"},"change_message_id":"b7c684d5f51a211d5f5b644ac528e4f013386a3f","unresolved":true,"context_lines":[{"line_number":57,"context_line":"Recordsets are created using the ``openstack recordset create`` command and"},{"line_number":58,"context_line":"require a zone, a name, a type, and data for the record."},{"line_number":59,"context_line":"To recreate the earlier example using the OpenStack client with the Designate"},{"line_number":60,"context_line":"plugin, the user would therefore run:"},{"line_number":61,"context_line":""},{"line_number":62,"context_line":""},{"line_number":63,"context_line":"   .. code-block:: console"}],"source_content_type":"text/x-rst","patch_set":7,"id":"e6cb0402_f9d92394","line":60,"range":{"start_line":60,"start_character":23,"end_line":60,"end_character":32},"updated":"2021-05-27 22:21:28.000000000","message":"Suggestion: remove \"therefore\" as it\u0027s not really needed.","commit_id":"8bd479ec82b433a1423cb0e97dec409775fd0efd"},{"author":{"_account_id":31933,"name":"Greg Rakauskas","display_name":"Greg Rakauskas","email":"gregraka@redhat.com","username":"gregraka"},"change_message_id":"b7c684d5f51a211d5f5b644ac528e4f013386a3f","unresolved":true,"context_lines":[{"line_number":83,"context_line":"      +-------------+--------------------------------------+"},{"line_number":84,"context_line":""},{"line_number":85,"context_line":"As the final argument ``www`` is not a fully qualified domain name (FQDN) it"},{"line_number":86,"context_line":"will be prepended to the zone name, but the same result would be achieved"},{"line_number":87,"context_line":"had ``www.example.org.`` been used. Note that the trailing ``.`` is essential"},{"line_number":88,"context_line":"-- its omission would result in a name of ``\"www.example.org.example.org.\"``."},{"line_number":89,"context_line":""}],"source_content_type":"text/x-rst","patch_set":7,"id":"cc293ef5_cf32ac4d","line":86,"range":{"start_line":86,"start_character":0,"end_line":86,"end_character":4},"updated":"2021-05-27 22:21:28.000000000","message":"Avoid future tense where possible. Suggest \"is\" here.","commit_id":"8bd479ec82b433a1423cb0e97dec409775fd0efd"},{"author":{"_account_id":31933,"name":"Greg Rakauskas","display_name":"Greg Rakauskas","email":"gregraka@redhat.com","username":"gregraka"},"change_message_id":"b7c684d5f51a211d5f5b644ac528e4f013386a3f","unresolved":true,"context_lines":[{"line_number":83,"context_line":"      +-------------+--------------------------------------+"},{"line_number":84,"context_line":""},{"line_number":85,"context_line":"As the final argument ``www`` is not a fully qualified domain name (FQDN) it"},{"line_number":86,"context_line":"will be prepended to the zone name, but the same result would be achieved"},{"line_number":87,"context_line":"had ``www.example.org.`` been used. Note that the trailing ``.`` is essential"},{"line_number":88,"context_line":"-- its omission would result in a name of ``\"www.example.org.example.org.\"``."},{"line_number":89,"context_line":""},{"line_number":90,"context_line":"The ``--record`` argument can be supplied multiple times to create multiple"},{"line_number":91,"context_line":"records within the recordset, for example for `Round-robin DNS`_."}],"source_content_type":"text/x-rst","patch_set":7,"id":"d636f620_9af10156","line":88,"range":{"start_line":86,"start_character":34,"end_line":88,"end_character":77},"updated":"2021-05-27 22:21:28.000000000","message":"Suggest that you break this into multiple sentences, and employ active voice and present tense:\n\n\"... is prepended to the zone name. However, you can achieve the same result by using ``www.example.org``. Note that the trailing ``.`` is required. Omitting it results in the name, ``\"www.example.org.example.org.\"``.\"","commit_id":"8bd479ec82b433a1423cb0e97dec409775fd0efd"},{"author":{"_account_id":6994,"name":"Michael Chapman","email":"woppin@gmail.com","username":"michaeltchapman"},"change_message_id":"b7e4cd75c9e6a0b84ff21681f73eee47daabf965","unresolved":true,"context_lines":[{"line_number":83,"context_line":"      +-------------+--------------------------------------+"},{"line_number":84,"context_line":""},{"line_number":85,"context_line":"As the final argument ``www`` is not a fully qualified domain name (FQDN) it"},{"line_number":86,"context_line":"will be prepended to the zone name, but the same result would be achieved"},{"line_number":87,"context_line":"had ``www.example.org.`` been used. Note that the trailing ``.`` is essential"},{"line_number":88,"context_line":"-- its omission would result in a name of ``\"www.example.org.example.org.\"``."},{"line_number":89,"context_line":""},{"line_number":90,"context_line":"The ``--record`` argument can be supplied multiple times to create multiple"},{"line_number":91,"context_line":"records within the recordset, for example for `Round-robin DNS`_."}],"source_content_type":"text/x-rst","patch_set":7,"id":"12393192_ce308233","line":88,"range":{"start_line":86,"start_character":34,"end_line":88,"end_character":77},"in_reply_to":"d636f620_9af10156","updated":"2021-06-08 02:23:16.000000000","message":"Not totally happy with this para tbh, it\u0027s stilted","commit_id":"8bd479ec82b433a1423cb0e97dec409775fd0efd"},{"author":{"_account_id":31933,"name":"Greg Rakauskas","display_name":"Greg Rakauskas","email":"gregraka@redhat.com","username":"gregraka"},"change_message_id":"b7c684d5f51a211d5f5b644ac528e4f013386a3f","unresolved":true,"context_lines":[{"line_number":87,"context_line":"had ``www.example.org.`` been used. Note that the trailing ``.`` is essential"},{"line_number":88,"context_line":"-- its omission would result in a name of ``\"www.example.org.example.org.\"``."},{"line_number":89,"context_line":""},{"line_number":90,"context_line":"The ``--record`` argument can be supplied multiple times to create multiple"},{"line_number":91,"context_line":"records within the recordset, for example for `Round-robin DNS`_."},{"line_number":92,"context_line":""},{"line_number":93,"context_line":""},{"line_number":94,"context_line":"   .. code-block:: console"}],"source_content_type":"text/x-rst","patch_set":7,"id":"229965cc_64ea9366","line":91,"range":{"start_line":90,"start_character":0,"end_line":91,"end_character":65},"updated":"2021-05-27 22:21:28.000000000","message":"Suggest that you use active voice:\n\nYou can use the ``--record`` argument multiple times to create multiple\nrecords within the recordset. A typical use for this is when you are implementing `Round-robin DNS`_.","commit_id":"8bd479ec82b433a1423cb0e97dec409775fd0efd"},{"author":{"_account_id":6994,"name":"Michael Chapman","email":"woppin@gmail.com","username":"michaeltchapman"},"change_message_id":"b7e4cd75c9e6a0b84ff21681f73eee47daabf965","unresolved":false,"context_lines":[{"line_number":87,"context_line":"had ``www.example.org.`` been used. Note that the trailing ``.`` is essential"},{"line_number":88,"context_line":"-- its omission would result in a name of ``\"www.example.org.example.org.\"``."},{"line_number":89,"context_line":""},{"line_number":90,"context_line":"The ``--record`` argument can be supplied multiple times to create multiple"},{"line_number":91,"context_line":"records within the recordset, for example for `Round-robin DNS`_."},{"line_number":92,"context_line":""},{"line_number":93,"context_line":""},{"line_number":94,"context_line":"   .. code-block:: console"}],"source_content_type":"text/x-rst","patch_set":7,"id":"956f3ccf_8b798b87","line":91,"range":{"start_line":90,"start_character":0,"end_line":91,"end_character":65},"in_reply_to":"229965cc_64ea9366","updated":"2021-06-08 02:23:16.000000000","message":"Done","commit_id":"8bd479ec82b433a1423cb0e97dec409775fd0efd"},{"author":{"_account_id":31933,"name":"Greg Rakauskas","display_name":"Greg Rakauskas","email":"gregraka@redhat.com","username":"gregraka"},"change_message_id":"b7c684d5f51a211d5f5b644ac528e4f013386a3f","unresolved":true,"context_lines":[{"line_number":114,"context_line":"      | zone_name   | example.org.                         |"},{"line_number":115,"context_line":"      +-------------+--------------------------------------+"},{"line_number":116,"context_line":""},{"line_number":117,"context_line":"The recordsets for a zone can be seen using the list command:"},{"line_number":118,"context_line":""},{"line_number":119,"context_line":"   .. code-block:: console"},{"line_number":120,"context_line":""}],"source_content_type":"text/x-rst","patch_set":7,"id":"b95b1647_90241a84","line":117,"range":{"start_line":117,"start_character":0,"end_line":117,"end_character":61},"updated":"2021-05-27 22:21:28.000000000","message":"Suggest active voice:\n\n\"You can view the recordsets in a zone by using the list command:\"","commit_id":"8bd479ec82b433a1423cb0e97dec409775fd0efd"},{"author":{"_account_id":6994,"name":"Michael Chapman","email":"woppin@gmail.com","username":"michaeltchapman"},"change_message_id":"b7e4cd75c9e6a0b84ff21681f73eee47daabf965","unresolved":false,"context_lines":[{"line_number":114,"context_line":"      | zone_name   | example.org.                         |"},{"line_number":115,"context_line":"      +-------------+--------------------------------------+"},{"line_number":116,"context_line":""},{"line_number":117,"context_line":"The recordsets for a zone can be seen using the list command:"},{"line_number":118,"context_line":""},{"line_number":119,"context_line":"   .. code-block:: console"},{"line_number":120,"context_line":""}],"source_content_type":"text/x-rst","patch_set":7,"id":"86aa8596_3159fe18","line":117,"range":{"start_line":117,"start_character":0,"end_line":117,"end_character":61},"in_reply_to":"b95b1647_90241a84","updated":"2021-06-08 02:23:16.000000000","message":"Done","commit_id":"8bd479ec82b433a1423cb0e97dec409775fd0efd"},{"author":{"_account_id":31933,"name":"Greg Rakauskas","display_name":"Greg Rakauskas","email":"gregraka@redhat.com","username":"gregraka"},"change_message_id":"b7c684d5f51a211d5f5b644ac528e4f013386a3f","unresolved":true,"context_lines":[{"line_number":132,"context_line":"The ``SOA`` and ``NS`` records for the zone are also visible here, but cannot"},{"line_number":133,"context_line":"be modified."},{"line_number":134,"context_line":""},{"line_number":135,"context_line":"The authoritative nameserver for the zone will be listed as the record data"},{"line_number":136,"context_line":"for the ``NS`` type record of the zone, which in this example is"},{"line_number":137,"context_line":"``ns1.example.net.``. It can be queried using ``dig`` to verify the results:"},{"line_number":138,"context_line":""}],"source_content_type":"text/x-rst","patch_set":7,"id":"479d72af_5e6d2766","line":135,"range":{"start_line":135,"start_character":42,"end_line":135,"end_character":47},"updated":"2021-05-27 22:21:28.000000000","message":"Try to stay in present tense unless it makes sense to use another tense.","commit_id":"8bd479ec82b433a1423cb0e97dec409775fd0efd"},{"author":{"_account_id":6994,"name":"Michael Chapman","email":"woppin@gmail.com","username":"michaeltchapman"},"change_message_id":"b7e4cd75c9e6a0b84ff21681f73eee47daabf965","unresolved":false,"context_lines":[{"line_number":132,"context_line":"The ``SOA`` and ``NS`` records for the zone are also visible here, but cannot"},{"line_number":133,"context_line":"be modified."},{"line_number":134,"context_line":""},{"line_number":135,"context_line":"The authoritative nameserver for the zone will be listed as the record data"},{"line_number":136,"context_line":"for the ``NS`` type record of the zone, which in this example is"},{"line_number":137,"context_line":"``ns1.example.net.``. It can be queried using ``dig`` to verify the results:"},{"line_number":138,"context_line":""}],"source_content_type":"text/x-rst","patch_set":7,"id":"8d289715_e64683c9","line":135,"range":{"start_line":135,"start_character":42,"end_line":135,"end_character":47},"in_reply_to":"479d72af_5e6d2766","updated":"2021-06-08 02:23:16.000000000","message":"Done","commit_id":"8bd479ec82b433a1423cb0e97dec409775fd0efd"},{"author":{"_account_id":31933,"name":"Greg Rakauskas","display_name":"Greg Rakauskas","email":"gregraka@redhat.com","username":"gregraka"},"change_message_id":"b7c684d5f51a211d5f5b644ac528e4f013386a3f","unresolved":true,"context_lines":[{"line_number":134,"context_line":""},{"line_number":135,"context_line":"The authoritative nameserver for the zone will be listed as the record data"},{"line_number":136,"context_line":"for the ``NS`` type record of the zone, which in this example is"},{"line_number":137,"context_line":"``ns1.example.net.``. It can be queried using ``dig`` to verify the results:"},{"line_number":138,"context_line":""},{"line_number":139,"context_line":"   .. code-block:: console"},{"line_number":140,"context_line":""}],"source_content_type":"text/x-rst","patch_set":7,"id":"0d780881_2891a891","line":137,"range":{"start_line":137,"start_character":22,"end_line":137,"end_character":76},"updated":"2021-05-27 22:21:28.000000000","message":"Suggest:\n\n  \"To verify the results, you can query the ``NS`` record by using ``dig``:","commit_id":"8bd479ec82b433a1423cb0e97dec409775fd0efd"},{"author":{"_account_id":6994,"name":"Michael Chapman","email":"woppin@gmail.com","username":"michaeltchapman"},"change_message_id":"b7e4cd75c9e6a0b84ff21681f73eee47daabf965","unresolved":false,"context_lines":[{"line_number":134,"context_line":""},{"line_number":135,"context_line":"The authoritative nameserver for the zone will be listed as the record data"},{"line_number":136,"context_line":"for the ``NS`` type record of the zone, which in this example is"},{"line_number":137,"context_line":"``ns1.example.net.``. It can be queried using ``dig`` to verify the results:"},{"line_number":138,"context_line":""},{"line_number":139,"context_line":"   .. code-block:: console"},{"line_number":140,"context_line":""}],"source_content_type":"text/x-rst","patch_set":7,"id":"ce81f58a_8d893513","line":137,"range":{"start_line":137,"start_character":22,"end_line":137,"end_character":76},"in_reply_to":"0d780881_2891a891","updated":"2021-06-08 02:23:16.000000000","message":"Done","commit_id":"8bd479ec82b433a1423cb0e97dec409775fd0efd"},{"author":{"_account_id":31933,"name":"Greg Rakauskas","display_name":"Greg Rakauskas","email":"gregraka@redhat.com","username":"gregraka"},"change_message_id":"b7c684d5f51a211d5f5b644ac528e4f013386a3f","unresolved":true,"context_lines":[{"line_number":190,"context_line":"Updating a recordset"},{"line_number":191,"context_line":"--------------------"},{"line_number":192,"context_line":""},{"line_number":193,"context_line":"A recordset can be modified using the ``recordset set`` command and supplying"},{"line_number":194,"context_line":"new data."},{"line_number":195,"context_line":""},{"line_number":196,"context_line":"   .. code-block:: console"},{"line_number":197,"context_line":""}],"source_content_type":"text/x-rst","patch_set":7,"id":"c83e0116_217e057d","line":194,"range":{"start_line":193,"start_character":0,"end_line":194,"end_character":9},"updated":"2021-05-27 22:21:28.000000000","message":"Suggest active voice:\n\n\"You can modify a recordset by using the ``openstack recordset set`` command. When updating a recordset by name, you must use the FQDN. As with most OpenStack commands, you can also use recordset ID.\"","commit_id":"8bd479ec82b433a1423cb0e97dec409775fd0efd"},{"author":{"_account_id":6994,"name":"Michael Chapman","email":"woppin@gmail.com","username":"michaeltchapman"},"change_message_id":"b7e4cd75c9e6a0b84ff21681f73eee47daabf965","unresolved":false,"context_lines":[{"line_number":190,"context_line":"Updating a recordset"},{"line_number":191,"context_line":"--------------------"},{"line_number":192,"context_line":""},{"line_number":193,"context_line":"A recordset can be modified using the ``recordset set`` command and supplying"},{"line_number":194,"context_line":"new data."},{"line_number":195,"context_line":""},{"line_number":196,"context_line":"   .. code-block:: console"},{"line_number":197,"context_line":""}],"source_content_type":"text/x-rst","patch_set":7,"id":"cccffaf7_f5271483","line":194,"range":{"start_line":193,"start_character":0,"end_line":194,"end_character":9},"in_reply_to":"c83e0116_217e057d","updated":"2021-06-08 02:23:16.000000000","message":"Done","commit_id":"8bd479ec82b433a1423cb0e97dec409775fd0efd"},{"author":{"_account_id":31933,"name":"Greg Rakauskas","display_name":"Greg Rakauskas","email":"gregraka@redhat.com","username":"gregraka"},"change_message_id":"b7c684d5f51a211d5f5b644ac528e4f013386a3f","unresolved":true,"context_lines":[{"line_number":216,"context_line":"       | zone_name   | example.org.                         |"},{"line_number":217,"context_line":"       +-------------+--------------------------------------+"},{"line_number":218,"context_line":""},{"line_number":219,"context_line":"In contrast to recordset creation, the FQDN must be used when updating a"},{"line_number":220,"context_line":"recordset by name. As with most OpenStack operations, the ID can also"},{"line_number":221,"context_line":"be used."},{"line_number":222,"context_line":""},{"line_number":223,"context_line":"Deleting a recordset"},{"line_number":224,"context_line":"--------------------"},{"line_number":225,"context_line":""}],"source_content_type":"text/x-rst","patch_set":7,"id":"3ae9b485_91d82bb4","line":222,"range":{"start_line":219,"start_character":0,"end_line":222,"end_character":0},"updated":"2021-05-27 22:21:28.000000000","message":"If you accept the earlier suggestion, then you can delete this paragraph.","commit_id":"8bd479ec82b433a1423cb0e97dec409775fd0efd"},{"author":{"_account_id":6994,"name":"Michael Chapman","email":"woppin@gmail.com","username":"michaeltchapman"},"change_message_id":"b7e4cd75c9e6a0b84ff21681f73eee47daabf965","unresolved":false,"context_lines":[{"line_number":216,"context_line":"       | zone_name   | example.org.                         |"},{"line_number":217,"context_line":"       +-------------+--------------------------------------+"},{"line_number":218,"context_line":""},{"line_number":219,"context_line":"In contrast to recordset creation, the FQDN must be used when updating a"},{"line_number":220,"context_line":"recordset by name. As with most OpenStack operations, the ID can also"},{"line_number":221,"context_line":"be used."},{"line_number":222,"context_line":""},{"line_number":223,"context_line":"Deleting a recordset"},{"line_number":224,"context_line":"--------------------"},{"line_number":225,"context_line":""}],"source_content_type":"text/x-rst","patch_set":7,"id":"ef28a5a0_213d7be0","line":222,"range":{"start_line":219,"start_character":0,"end_line":222,"end_character":0},"in_reply_to":"3ae9b485_91d82bb4","updated":"2021-06-08 02:23:16.000000000","message":"Done","commit_id":"8bd479ec82b433a1423cb0e97dec409775fd0efd"},{"author":{"_account_id":31933,"name":"Greg Rakauskas","display_name":"Greg Rakauskas","email":"gregraka@redhat.com","username":"gregraka"},"change_message_id":"b7c684d5f51a211d5f5b644ac528e4f013386a3f","unresolved":true,"context_lines":[{"line_number":223,"context_line":"Deleting a recordset"},{"line_number":224,"context_line":"--------------------"},{"line_number":225,"context_line":""},{"line_number":226,"context_line":"If a recordset is no longer required, it can be deleted by providing the"},{"line_number":227,"context_line":"recordset name and its parent zone:"},{"line_number":228,"context_line":""},{"line_number":229,"context_line":"   .. code-block:: console"},{"line_number":230,"context_line":""}],"source_content_type":"text/x-rst","patch_set":7,"id":"af2de6ab_2b45c76a","line":227,"range":{"start_line":226,"start_character":0,"end_line":227,"end_character":35},"updated":"2021-05-27 22:21:28.000000000","message":"Suggestion: It\u0027s helpful to users to introduce a procedure with a \"Why?\"\n\nFor example:\n\n\" There can be situations when you want to remove a recordset. For example, you might have added a record to a another recordset and now want to delete the original recordset. \n\nYou can use the `openstack recordset delete` command to remove recordsets. Designate requires that you specify the FQDN to properly identify the record that you are deleting.\"","commit_id":"8bd479ec82b433a1423cb0e97dec409775fd0efd"},{"author":{"_account_id":6994,"name":"Michael Chapman","email":"woppin@gmail.com","username":"michaeltchapman"},"change_message_id":"b7e4cd75c9e6a0b84ff21681f73eee47daabf965","unresolved":false,"context_lines":[{"line_number":223,"context_line":"Deleting a recordset"},{"line_number":224,"context_line":"--------------------"},{"line_number":225,"context_line":""},{"line_number":226,"context_line":"If a recordset is no longer required, it can be deleted by providing the"},{"line_number":227,"context_line":"recordset name and its parent zone:"},{"line_number":228,"context_line":""},{"line_number":229,"context_line":"   .. code-block:: console"},{"line_number":230,"context_line":""}],"source_content_type":"text/x-rst","patch_set":7,"id":"546ed500_0ab019ce","line":227,"range":{"start_line":226,"start_character":0,"end_line":227,"end_character":35},"in_reply_to":"af2de6ab_2b45c76a","updated":"2021-06-08 02:23:16.000000000","message":"I think for the CRUD ops the why is not needed but I\u0027ll keep that in mind for other sections.","commit_id":"8bd479ec82b433a1423cb0e97dec409775fd0efd"},{"author":{"_account_id":31933,"name":"Greg Rakauskas","display_name":"Greg Rakauskas","email":"gregraka@redhat.com","username":"gregraka"},"change_message_id":"b7c684d5f51a211d5f5b644ac528e4f013386a3f","unresolved":true,"context_lines":[{"line_number":249,"context_line":"       | zone_name   | example.org.                         |"},{"line_number":250,"context_line":"       +-------------+--------------------------------------+"},{"line_number":251,"context_line":""},{"line_number":252,"context_line":"Similar to updating a record, the FQDN must be used to identify the record"},{"line_number":253,"context_line":"when performing a delete."},{"line_number":254,"context_line":""},{"line_number":255,"context_line":".. _wikipedia: https://en.wikipedia.org/wiki/List_of_DNS_record_types"},{"line_number":256,"context_line":".. _RFC: https://tools.ietf.org/html/rfc1035#section-3.2."},{"line_number":257,"context_line":".. _Round-robin DNS: https://en.wikipedia.org/wiki/Round-robin_DNS"}],"source_content_type":"text/x-rst","patch_set":7,"id":"ff0f6ed9_78508aa7","line":254,"range":{"start_line":252,"start_character":0,"end_line":254,"end_character":0},"updated":"2021-05-27 22:21:28.000000000","message":"If you accept the earlier suggestion, then you can delete this sentence.","commit_id":"8bd479ec82b433a1423cb0e97dec409775fd0efd"},{"author":{"_account_id":6994,"name":"Michael Chapman","email":"woppin@gmail.com","username":"michaeltchapman"},"change_message_id":"b7e4cd75c9e6a0b84ff21681f73eee47daabf965","unresolved":false,"context_lines":[{"line_number":249,"context_line":"       | zone_name   | example.org.                         |"},{"line_number":250,"context_line":"       +-------------+--------------------------------------+"},{"line_number":251,"context_line":""},{"line_number":252,"context_line":"Similar to updating a record, the FQDN must be used to identify the record"},{"line_number":253,"context_line":"when performing a delete."},{"line_number":254,"context_line":""},{"line_number":255,"context_line":".. _wikipedia: https://en.wikipedia.org/wiki/List_of_DNS_record_types"},{"line_number":256,"context_line":".. _RFC: https://tools.ietf.org/html/rfc1035#section-3.2."},{"line_number":257,"context_line":".. _Round-robin DNS: https://en.wikipedia.org/wiki/Round-robin_DNS"}],"source_content_type":"text/x-rst","patch_set":7,"id":"485b946a_4ebe70f9","line":254,"range":{"start_line":252,"start_character":0,"end_line":254,"end_character":0},"in_reply_to":"ff0f6ed9_78508aa7","updated":"2021-06-08 02:23:16.000000000","message":"Done","commit_id":"8bd479ec82b433a1423cb0e97dec409775fd0efd"},{"author":{"_account_id":11628,"name":"Michael Johnson","email":"johnsomor@gmail.com","username":"johnsom"},"change_message_id":"b7a6a7a698a77c1bcf3d5ce99813ba3624bddab3","unresolved":true,"context_lines":[{"line_number":24,"context_line":""},{"line_number":25,"context_line":"- **Name:** the string that indicates its location in the DNS namespace;"},{"line_number":26,"context_line":"- **Type:** the set of `letter codes`_ that identify the record\u0027s usage. For"},{"line_number":27,"context_line":"  example ``MX`` for mail delivery or ``NS`` record for zone delegation;"},{"line_number":28,"context_line":"- **Class:** the set of letter codes that specify the namespace for the"},{"line_number":29,"context_line":"  record. Typically, this is ``IN`` for internet, though other namespaces do"},{"line_number":30,"context_line":"  exist."}],"source_content_type":"text/x-rst","patch_set":8,"id":"31b3a657_46b0d9d5","line":27,"range":{"start_line":27,"start_character":38,"end_line":27,"end_character":44},"updated":"2021-06-08 21:45:45.000000000","message":"A records are more common and you use A and CNAME records below. Maybe we should use those as examples here.","commit_id":"7e428f311242448e0d71f4b4aaf07efc5b0abd91"},{"author":{"_account_id":6994,"name":"Michael Chapman","email":"woppin@gmail.com","username":"michaeltchapman"},"change_message_id":"012d4fbf97f725d3fd37fd1e3a887f95d4e17368","unresolved":false,"context_lines":[{"line_number":24,"context_line":""},{"line_number":25,"context_line":"- **Name:** the string that indicates its location in the DNS namespace;"},{"line_number":26,"context_line":"- **Type:** the set of `letter codes`_ that identify the record\u0027s usage. For"},{"line_number":27,"context_line":"  example ``MX`` for mail delivery or ``NS`` record for zone delegation;"},{"line_number":28,"context_line":"- **Class:** the set of letter codes that specify the namespace for the"},{"line_number":29,"context_line":"  record. Typically, this is ``IN`` for internet, though other namespaces do"},{"line_number":30,"context_line":"  exist."}],"source_content_type":"text/x-rst","patch_set":8,"id":"1793321c_e9b59963","line":27,"range":{"start_line":27,"start_character":38,"end_line":27,"end_character":44},"in_reply_to":"31b3a657_46b0d9d5","updated":"2021-06-09 05:57:22.000000000","message":"Done","commit_id":"7e428f311242448e0d71f4b4aaf07efc5b0abd91"},{"author":{"_account_id":11628,"name":"Michael Johnson","email":"johnsomor@gmail.com","username":"johnsom"},"change_message_id":"b7a6a7a698a77c1bcf3d5ce99813ba3624bddab3","unresolved":true,"context_lines":[{"line_number":25,"context_line":"- **Name:** the string that indicates its location in the DNS namespace;"},{"line_number":26,"context_line":"- **Type:** the set of `letter codes`_ that identify the record\u0027s usage. For"},{"line_number":27,"context_line":"  example ``MX`` for mail delivery or ``NS`` record for zone delegation;"},{"line_number":28,"context_line":"- **Class:** the set of letter codes that specify the namespace for the"},{"line_number":29,"context_line":"  record. Typically, this is ``IN`` for internet, though other namespaces do"},{"line_number":30,"context_line":"  exist."},{"line_number":31,"context_line":"- **TTL:** the duration in seconds that the record remains valid;"}],"source_content_type":"text/x-rst","patch_set":8,"id":"f661684e_0b052136","line":28,"range":{"start_line":28,"start_character":54,"end_line":28,"end_character":63},"updated":"2021-06-08 21:45:45.000000000","message":"namespace may be confusing here as you use the word namespace above describing the DNS hierarchy.","commit_id":"7e428f311242448e0d71f4b4aaf07efc5b0abd91"},{"author":{"_account_id":6994,"name":"Michael Chapman","email":"woppin@gmail.com","username":"michaeltchapman"},"change_message_id":"012d4fbf97f725d3fd37fd1e3a887f95d4e17368","unresolved":true,"context_lines":[{"line_number":25,"context_line":"- **Name:** the string that indicates its location in the DNS namespace;"},{"line_number":26,"context_line":"- **Type:** the set of `letter codes`_ that identify the record\u0027s usage. For"},{"line_number":27,"context_line":"  example ``MX`` for mail delivery or ``NS`` record for zone delegation;"},{"line_number":28,"context_line":"- **Class:** the set of letter codes that specify the namespace for the"},{"line_number":29,"context_line":"  record. Typically, this is ``IN`` for internet, though other namespaces do"},{"line_number":30,"context_line":"  exist."},{"line_number":31,"context_line":"- **TTL:** the duration in seconds that the record remains valid;"}],"source_content_type":"text/x-rst","patch_set":8,"id":"8a133f39_44c1001c","line":28,"range":{"start_line":28,"start_character":54,"end_line":28,"end_character":63},"in_reply_to":"f661684e_0b052136","updated":"2021-06-09 05:57:22.000000000","message":"Is the issue with the above section saying \"the DNS namespace\" when it\u0027s actually \"a DNS namespace\" because there are many classes with one namespace each? I don\u0027t think I have a better way to describe this.","commit_id":"7e428f311242448e0d71f4b4aaf07efc5b0abd91"},{"author":{"_account_id":11628,"name":"Michael Johnson","email":"johnsomor@gmail.com","username":"johnsom"},"change_message_id":"b7a6a7a698a77c1bcf3d5ce99813ba3624bddab3","unresolved":true,"context_lines":[{"line_number":28,"context_line":"- **Class:** the set of letter codes that specify the namespace for the"},{"line_number":29,"context_line":"  record. Typically, this is ``IN`` for internet, though other namespaces do"},{"line_number":30,"context_line":"  exist."},{"line_number":31,"context_line":"- **TTL:** the duration in seconds that the record remains valid;"},{"line_number":32,"context_line":"- **Rdata:** the data for the record, such as an IP address for an ``A`` type"},{"line_number":33,"context_line":"  record or another record name for a ``CNAME`` type record."},{"line_number":34,"context_line":""}],"source_content_type":"text/x-rst","patch_set":8,"id":"2f8f9d7e_53df5379","line":31,"range":{"start_line":31,"start_character":64,"end_line":31,"end_character":65},"updated":"2021-06-08 21:45:45.000000000","message":"Semicolons and periods are mixed in this list. We should be consistent. Most lists use periods.","commit_id":"7e428f311242448e0d71f4b4aaf07efc5b0abd91"},{"author":{"_account_id":6994,"name":"Michael Chapman","email":"woppin@gmail.com","username":"michaeltchapman"},"change_message_id":"012d4fbf97f725d3fd37fd1e3a887f95d4e17368","unresolved":false,"context_lines":[{"line_number":28,"context_line":"- **Class:** the set of letter codes that specify the namespace for the"},{"line_number":29,"context_line":"  record. Typically, this is ``IN`` for internet, though other namespaces do"},{"line_number":30,"context_line":"  exist."},{"line_number":31,"context_line":"- **TTL:** the duration in seconds that the record remains valid;"},{"line_number":32,"context_line":"- **Rdata:** the data for the record, such as an IP address for an ``A`` type"},{"line_number":33,"context_line":"  record or another record name for a ``CNAME`` type record."},{"line_number":34,"context_line":""}],"source_content_type":"text/x-rst","patch_set":8,"id":"5e36b741_9e1f6058","line":31,"range":{"start_line":31,"start_character":64,"end_line":31,"end_character":65},"in_reply_to":"2f8f9d7e_53df5379","updated":"2021-06-09 05:57:22.000000000","message":"Done","commit_id":"7e428f311242448e0d71f4b4aaf07efc5b0abd91"},{"author":{"_account_id":11628,"name":"Michael Johnson","email":"johnsomor@gmail.com","username":"johnsom"},"change_message_id":"b7a6a7a698a77c1bcf3d5ce99813ba3624bddab3","unresolved":true,"context_lines":[{"line_number":29,"context_line":"  record. Typically, this is ``IN`` for internet, though other namespaces do"},{"line_number":30,"context_line":"  exist."},{"line_number":31,"context_line":"- **TTL:** the duration in seconds that the record remains valid;"},{"line_number":32,"context_line":"- **Rdata:** the data for the record, such as an IP address for an ``A`` type"},{"line_number":33,"context_line":"  record or another record name for a ``CNAME`` type record."},{"line_number":34,"context_line":""},{"line_number":35,"context_line":"Recordsets in Designate"}],"source_content_type":"text/x-rst","patch_set":8,"id":"f06bdfad_1ac6bfaf","line":32,"range":{"start_line":32,"start_character":4,"end_line":32,"end_character":9},"updated":"2021-06-08 21:45:45.000000000","message":"Should we be consistent with the API here?\nThe API calls this the \"records\".\nhttps://docs.openstack.org/api-ref/dns/?expanded\u003dcreate-recordset-detail#id75","commit_id":"7e428f311242448e0d71f4b4aaf07efc5b0abd91"},{"author":{"_account_id":6994,"name":"Michael Chapman","email":"woppin@gmail.com","username":"michaeltchapman"},"change_message_id":"012d4fbf97f725d3fd37fd1e3a887f95d4e17368","unresolved":true,"context_lines":[{"line_number":29,"context_line":"  record. Typically, this is ``IN`` for internet, though other namespaces do"},{"line_number":30,"context_line":"  exist."},{"line_number":31,"context_line":"- **TTL:** the duration in seconds that the record remains valid;"},{"line_number":32,"context_line":"- **Rdata:** the data for the record, such as an IP address for an ``A`` type"},{"line_number":33,"context_line":"  record or another record name for a ``CNAME`` type record."},{"line_number":34,"context_line":""},{"line_number":35,"context_line":"Recordsets in Designate"}],"source_content_type":"text/x-rst","patch_set":8,"id":"1b700c08_8eefe509","line":32,"range":{"start_line":32,"start_character":4,"end_line":32,"end_character":9},"in_reply_to":"f06bdfad_1ac6bfaf","updated":"2021-06-09 05:57:22.000000000","message":"\"each record has a ... records\" seemed confusing + This section is attempting to succinctly describe the DNS concept, with the below sections describing how designate manages the DNS concept, so using the DNS terminology seems appropriate.","commit_id":"7e428f311242448e0d71f4b4aaf07efc5b0abd91"},{"author":{"_account_id":11628,"name":"Michael Johnson","email":"johnsomor@gmail.com","username":"johnsom"},"change_message_id":"b7a6a7a698a77c1bcf3d5ce99813ba3624bddab3","unresolved":true,"context_lines":[{"line_number":38,"context_line":"DNS records in Designate are managed using ``Recordsets``, which represent one"},{"line_number":39,"context_line":"or more DNS records with the same `Name` and `Type`, but potentially different"},{"line_number":40,"context_line":"data. For example, a recordset named ``www.example.com``, with a type of ``A``,"},{"line_number":41,"context_line":"that contains the data ``10.0.0.1`` and ``10.0.0.2`` might reflect two web"},{"line_number":42,"context_line":"servers hosting ``www.example.com`` located at those two IP addresses."},{"line_number":43,"context_line":""},{"line_number":44,"context_line":"You must create Recordsets within a zone. If you delete a zone that contains"}],"source_content_type":"text/x-rst","patch_set":8,"id":"e6c0f8f4_ef5f0c1c","line":41,"range":{"start_line":41,"start_character":25,"end_line":41,"end_character":33},"updated":"2021-06-08 21:45:45.000000000","message":"Please use a documentation IP address subnet,\n192.0.2.0/24\n198.51.100.0/24\n203.0.113.0/24","commit_id":"7e428f311242448e0d71f4b4aaf07efc5b0abd91"},{"author":{"_account_id":6994,"name":"Michael Chapman","email":"woppin@gmail.com","username":"michaeltchapman"},"change_message_id":"012d4fbf97f725d3fd37fd1e3a887f95d4e17368","unresolved":false,"context_lines":[{"line_number":38,"context_line":"DNS records in Designate are managed using ``Recordsets``, which represent one"},{"line_number":39,"context_line":"or more DNS records with the same `Name` and `Type`, but potentially different"},{"line_number":40,"context_line":"data. For example, a recordset named ``www.example.com``, with a type of ``A``,"},{"line_number":41,"context_line":"that contains the data ``10.0.0.1`` and ``10.0.0.2`` might reflect two web"},{"line_number":42,"context_line":"servers hosting ``www.example.com`` located at those two IP addresses."},{"line_number":43,"context_line":""},{"line_number":44,"context_line":"You must create Recordsets within a zone. If you delete a zone that contains"}],"source_content_type":"text/x-rst","patch_set":8,"id":"9bf2e911_5eb4351e","line":41,"range":{"start_line":41,"start_character":25,"end_line":41,"end_character":33},"in_reply_to":"e6c0f8f4_ef5f0c1c","updated":"2021-06-09 05:57:22.000000000","message":"Done","commit_id":"7e428f311242448e0d71f4b4aaf07efc5b0abd91"},{"author":{"_account_id":11628,"name":"Michael Johnson","email":"johnsomor@gmail.com","username":"johnsom"},"change_message_id":"b7a6a7a698a77c1bcf3d5ce99813ba3624bddab3","unresolved":true,"context_lines":[{"line_number":131,"context_line":""},{"line_number":132,"context_line":"The authoritative nameserver for the is listed as the record data for the"},{"line_number":133,"context_line":"``NS`` type record of the zone, which in this example is ``ns1.example.net.``."},{"line_number":134,"context_line":"To verify the results you can query the ``NS`` record using ``dig``:"},{"line_number":135,"context_line":""},{"line_number":136,"context_line":"   .. code-block:: console"},{"line_number":137,"context_line":""}],"source_content_type":"text/x-rst","patch_set":8,"id":"fc46b0f7_eea7160e","line":134,"range":{"start_line":134,"start_character":0,"end_line":134,"end_character":68},"updated":"2021-06-08 21:45:45.000000000","message":"This says \"to query the NS record, but it is doing a normal A record lookup.","commit_id":"7e428f311242448e0d71f4b4aaf07efc5b0abd91"},{"author":{"_account_id":6994,"name":"Michael Chapman","email":"woppin@gmail.com","username":"michaeltchapman"},"change_message_id":"012d4fbf97f725d3fd37fd1e3a887f95d4e17368","unresolved":false,"context_lines":[{"line_number":131,"context_line":""},{"line_number":132,"context_line":"The authoritative nameserver for the is listed as the record data for the"},{"line_number":133,"context_line":"``NS`` type record of the zone, which in this example is ``ns1.example.net.``."},{"line_number":134,"context_line":"To verify the results you can query the ``NS`` record using ``dig``:"},{"line_number":135,"context_line":""},{"line_number":136,"context_line":"   .. code-block:: console"},{"line_number":137,"context_line":""}],"source_content_type":"text/x-rst","patch_set":8,"id":"eb682521_e1d130c7","line":134,"range":{"start_line":134,"start_character":0,"end_line":134,"end_character":68},"in_reply_to":"fc46b0f7_eea7160e","updated":"2021-06-09 05:57:22.000000000","message":"Done","commit_id":"7e428f311242448e0d71f4b4aaf07efc5b0abd91"},{"author":{"_account_id":11628,"name":"Michael Johnson","email":"johnsomor@gmail.com","username":"johnsom"},"change_message_id":"b7a6a7a698a77c1bcf3d5ce99813ba3624bddab3","unresolved":true,"context_lines":[{"line_number":135,"context_line":""},{"line_number":136,"context_line":"   .. code-block:: console"},{"line_number":137,"context_line":""},{"line_number":138,"context_line":"       $ dig @ns1.example.net www.example.org."},{"line_number":139,"context_line":""},{"line_number":140,"context_line":"       ; \u003c\u003c\u003e\u003e DiG 9.11.20-RedHat-9.11.20-5.el8_3.1 \u003c\u003c\u003e\u003e @ns1.example.net www.example.org."},{"line_number":141,"context_line":"       ; (1 server found)"}],"source_content_type":"text/x-rst","patch_set":8,"id":"fc890129_22cb469e","line":138,"updated":"2021-06-08 21:45:45.000000000","message":"This is a lot of excess information. Consider using the +short (or +noall +answer) option to return only the answer.","commit_id":"7e428f311242448e0d71f4b4aaf07efc5b0abd91"},{"author":{"_account_id":6994,"name":"Michael Chapman","email":"woppin@gmail.com","username":"michaeltchapman"},"change_message_id":"012d4fbf97f725d3fd37fd1e3a887f95d4e17368","unresolved":false,"context_lines":[{"line_number":135,"context_line":""},{"line_number":136,"context_line":"   .. code-block:: console"},{"line_number":137,"context_line":""},{"line_number":138,"context_line":"       $ dig @ns1.example.net www.example.org."},{"line_number":139,"context_line":""},{"line_number":140,"context_line":"       ; \u003c\u003c\u003e\u003e DiG 9.11.20-RedHat-9.11.20-5.el8_3.1 \u003c\u003c\u003e\u003e @ns1.example.net www.example.org."},{"line_number":141,"context_line":"       ; (1 server found)"}],"source_content_type":"text/x-rst","patch_set":8,"id":"7e891c81_6921bdf1","line":138,"in_reply_to":"fc890129_22cb469e","updated":"2021-06-09 05:57:22.000000000","message":"Done","commit_id":"7e428f311242448e0d71f4b4aaf07efc5b0abd91"},{"author":{"_account_id":11628,"name":"Michael Johnson","email":"johnsomor@gmail.com","username":"johnsom"},"change_message_id":"b7a6a7a698a77c1bcf3d5ce99813ba3624bddab3","unresolved":true,"context_lines":[{"line_number":159,"context_line":"       ;; WHEN: Mon May 03 03:36:42 UTC 2021"},{"line_number":160,"context_line":"       ;; MSG SIZE  rcvd: 88"},{"line_number":161,"context_line":""},{"line_number":162,"context_line":"       $ dig @ns1.example.net web.example.org."},{"line_number":163,"context_line":""},{"line_number":164,"context_line":"       ; \u003c\u003c\u003e\u003e DiG 9.11.20-RedHat-9.11.20-5.el8_3.1 \u003c\u003c\u003e\u003e @ns1.example.net web.example.org."},{"line_number":165,"context_line":"       ; (1 server found)"}],"source_content_type":"text/x-rst","patch_set":8,"id":"ce858588_7934eb52","line":162,"updated":"2021-06-08 21:45:45.000000000","message":"Same here, +short or +noall +answer might be more clear.","commit_id":"7e428f311242448e0d71f4b4aaf07efc5b0abd91"},{"author":{"_account_id":6994,"name":"Michael Chapman","email":"woppin@gmail.com","username":"michaeltchapman"},"change_message_id":"012d4fbf97f725d3fd37fd1e3a887f95d4e17368","unresolved":false,"context_lines":[{"line_number":159,"context_line":"       ;; WHEN: Mon May 03 03:36:42 UTC 2021"},{"line_number":160,"context_line":"       ;; MSG SIZE  rcvd: 88"},{"line_number":161,"context_line":""},{"line_number":162,"context_line":"       $ dig @ns1.example.net web.example.org."},{"line_number":163,"context_line":""},{"line_number":164,"context_line":"       ; \u003c\u003c\u003e\u003e DiG 9.11.20-RedHat-9.11.20-5.el8_3.1 \u003c\u003c\u003e\u003e @ns1.example.net web.example.org."},{"line_number":165,"context_line":"       ; (1 server found)"}],"source_content_type":"text/x-rst","patch_set":8,"id":"39cd2607_e667d10c","line":162,"in_reply_to":"ce858588_7934eb52","updated":"2021-06-09 05:57:22.000000000","message":"Done","commit_id":"7e428f311242448e0d71f4b4aaf07efc5b0abd91"},{"author":{"_account_id":11628,"name":"Michael Johnson","email":"johnsomor@gmail.com","username":"johnsom"},"change_message_id":"b7a6a7a698a77c1bcf3d5ce99813ba3624bddab3","unresolved":true,"context_lines":[{"line_number":189,"context_line":""},{"line_number":190,"context_line":"You can modify a recordset by using the ``openstack recordset set`` command."},{"line_number":191,"context_line":"When updating a recordset by name, you must use the FQDN. As with most"},{"line_number":192,"context_line":"OpenStack commands, you can also use recordset ID."},{"line_number":193,"context_line":""},{"line_number":194,"context_line":"   .. code-block:: console"},{"line_number":195,"context_line":""}],"source_content_type":"text/x-rst","patch_set":8,"id":"e94cf2cd_713d59b3","line":192,"updated":"2021-06-08 21:45:45.000000000","message":"We might want to describe this example, that you are adding a second IP record for the www.example.org. name.","commit_id":"7e428f311242448e0d71f4b4aaf07efc5b0abd91"},{"author":{"_account_id":6994,"name":"Michael Chapman","email":"woppin@gmail.com","username":"michaeltchapman"},"change_message_id":"012d4fbf97f725d3fd37fd1e3a887f95d4e17368","unresolved":false,"context_lines":[{"line_number":189,"context_line":""},{"line_number":190,"context_line":"You can modify a recordset by using the ``openstack recordset set`` command."},{"line_number":191,"context_line":"When updating a recordset by name, you must use the FQDN. As with most"},{"line_number":192,"context_line":"OpenStack commands, you can also use recordset ID."},{"line_number":193,"context_line":""},{"line_number":194,"context_line":"   .. code-block:: console"},{"line_number":195,"context_line":""}],"source_content_type":"text/x-rst","patch_set":8,"id":"c40f2760_14fb05e9","line":192,"in_reply_to":"e94cf2cd_713d59b3","updated":"2021-06-09 05:57:22.000000000","message":"Done","commit_id":"7e428f311242448e0d71f4b4aaf07efc5b0abd91"},{"author":{"_account_id":11628,"name":"Michael Johnson","email":"johnsomor@gmail.com","username":"johnsom"},"change_message_id":"b7a6a7a698a77c1bcf3d5ce99813ba3624bddab3","unresolved":true,"context_lines":[{"line_number":244,"context_line":"       +-------------+--------------------------------------+"},{"line_number":245,"context_line":""},{"line_number":246,"context_line":".. _letter codes: https://en.wikipedia.org/wiki/List_of_DNS_record_types"},{"line_number":247,"context_line":".. _RFC: https://tools.ietf.org/html/rfc1035#section-3.2."},{"line_number":248,"context_line":".. _Round-robin DNS: https://en.wikipedia.org/wiki/Round-robin_DNS"}],"source_content_type":"text/x-rst","patch_set":8,"id":"f44165fd_29f437ea","line":247,"updated":"2021-06-08 21:45:45.000000000","message":"I don\u0027t see where this link is used. Is it extra?","commit_id":"7e428f311242448e0d71f4b4aaf07efc5b0abd91"},{"author":{"_account_id":6994,"name":"Michael Chapman","email":"woppin@gmail.com","username":"michaeltchapman"},"change_message_id":"012d4fbf97f725d3fd37fd1e3a887f95d4e17368","unresolved":false,"context_lines":[{"line_number":244,"context_line":"       +-------------+--------------------------------------+"},{"line_number":245,"context_line":""},{"line_number":246,"context_line":".. _letter codes: https://en.wikipedia.org/wiki/List_of_DNS_record_types"},{"line_number":247,"context_line":".. _RFC: https://tools.ietf.org/html/rfc1035#section-3.2."},{"line_number":248,"context_line":".. _Round-robin DNS: https://en.wikipedia.org/wiki/Round-robin_DNS"}],"source_content_type":"text/x-rst","patch_set":8,"id":"48fa21f7_dbbdb0c4","line":247,"in_reply_to":"f44165fd_29f437ea","updated":"2021-06-09 05:57:22.000000000","message":"Was used in a previous patchset. Done","commit_id":"7e428f311242448e0d71f4b4aaf07efc5b0abd91"}]}