)]}'
{"doc/source/user/importexport.rst":[{"author":{"_account_id":31933,"name":"Greg Rakauskas","display_name":"Greg Rakauskas","email":"gregraka@redhat.com","username":"gregraka"},"change_message_id":"e8de13a80fe71842205bef61dfa8dba3c8bd32cc","unresolved":true,"context_lines":[{"line_number":22,"context_line":"Overview"},{"line_number":23,"context_line":"\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d"},{"line_number":24,"context_line":""},{"line_number":25,"context_line":"Zones can be imported into and serialised out of Designate using the zone"},{"line_number":26,"context_line":"import and export APIs. Using the `zone file format`_ along with these APIs"},{"line_number":27,"context_line":"you can both create zones and recordsets in batches and move zones out of"},{"line_number":28,"context_line":"Designate easily."}],"source_content_type":"text/x-rst","patch_set":3,"id":"6a294650_56cd53a9","line":25,"updated":"2021-07-02 18:48:36.000000000","message":"Suggestion:\n\nYou can import and export zones into and out of designate using the import and export APIs. These APIs and the `zone file format`_ enable you to easily create zones and recordsets in batches and move** zones out of Designate.\n\n** Is \u0027move\u0027 the right verb here? Do you export zones in order to move them?","commit_id":"0031afb68bf959a5ca13b100e4528971e3ba58c0"},{"author":{"_account_id":6994,"name":"Michael Chapman","email":"woppin@gmail.com","username":"michaeltchapman"},"change_message_id":"6697b2c42d5b4550ca3bbad3807ad8cd3a8e80d7","unresolved":false,"context_lines":[{"line_number":22,"context_line":"Overview"},{"line_number":23,"context_line":"\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d"},{"line_number":24,"context_line":""},{"line_number":25,"context_line":"Zones can be imported into and serialised out of Designate using the zone"},{"line_number":26,"context_line":"import and export APIs. Using the `zone file format`_ along with these APIs"},{"line_number":27,"context_line":"you can both create zones and recordsets in batches and move zones out of"},{"line_number":28,"context_line":"Designate easily."}],"source_content_type":"text/x-rst","patch_set":3,"id":"49f8cd35_2aed404f","line":25,"in_reply_to":"6a294650_56cd53a9","updated":"2021-07-21 01:08:54.000000000","message":"Done.","commit_id":"0031afb68bf959a5ca13b100e4528971e3ba58c0"},{"author":{"_account_id":31933,"name":"Greg Rakauskas","display_name":"Greg Rakauskas","email":"gregraka@redhat.com","username":"gregraka"},"change_message_id":"e8de13a80fe71842205bef61dfa8dba3c8bd32cc","unresolved":true,"context_lines":[{"line_number":24,"context_line":""},{"line_number":25,"context_line":"Zones can be imported into and serialised out of Designate using the zone"},{"line_number":26,"context_line":"import and export APIs. Using the `zone file format`_ along with these APIs"},{"line_number":27,"context_line":"you can both create zones and recordsets in batches and move zones out of"},{"line_number":28,"context_line":"Designate easily."},{"line_number":29,"context_line":""},{"line_number":30,"context_line":"Zone Export"}],"source_content_type":"text/x-rst","patch_set":3,"id":"0ae10fb8_4f77e577","line":27,"range":{"start_line":27,"start_character":30,"end_line":27,"end_character":40},"updated":"2021-07-02 18:48:36.000000000","message":"Don\u0027t understand why recordsets are mentioned. How do they relate to zones? Does a zone consist of recordsets? (Pardon my ignorance.) :^)","commit_id":"0031afb68bf959a5ca13b100e4528971e3ba58c0"},{"author":{"_account_id":6994,"name":"Michael Chapman","email":"woppin@gmail.com","username":"michaeltchapman"},"change_message_id":"6697b2c42d5b4550ca3bbad3807ad8cd3a8e80d7","unresolved":false,"context_lines":[{"line_number":24,"context_line":""},{"line_number":25,"context_line":"Zones can be imported into and serialised out of Designate using the zone"},{"line_number":26,"context_line":"import and export APIs. Using the `zone file format`_ along with these APIs"},{"line_number":27,"context_line":"you can both create zones and recordsets in batches and move zones out of"},{"line_number":28,"context_line":"Designate easily."},{"line_number":29,"context_line":""},{"line_number":30,"context_line":"Zone Export"}],"source_content_type":"text/x-rst","patch_set":3,"id":"93b5fe78_e8d7fd3b","line":27,"range":{"start_line":27,"start_character":30,"end_line":27,"end_character":40},"in_reply_to":"0ae10fb8_4f77e577","updated":"2021-07-21 01:08:54.000000000","message":"Yes zones contain recordsets and each recordset is within exactly one zone.","commit_id":"0031afb68bf959a5ca13b100e4528971e3ba58c0"},{"author":{"_account_id":31933,"name":"Greg Rakauskas","display_name":"Greg Rakauskas","email":"gregraka@redhat.com","username":"gregraka"},"change_message_id":"e8de13a80fe71842205bef61dfa8dba3c8bd32cc","unresolved":true,"context_lines":[{"line_number":27,"context_line":"you can both create zones and recordsets in batches and move zones out of"},{"line_number":28,"context_line":"Designate easily."},{"line_number":29,"context_line":""},{"line_number":30,"context_line":"Zone Export"},{"line_number":31,"context_line":"\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d"},{"line_number":32,"context_line":""},{"line_number":33,"context_line":"You can export a zone file from Designate using the `zone export create`"}],"source_content_type":"text/x-rst","patch_set":3,"id":"accd438f_f504daca","line":30,"range":{"start_line":30,"start_character":0,"end_line":30,"end_character":11},"updated":"2021-07-02 18:48:36.000000000","message":"Perhaps \"Exporting Zones?\"","commit_id":"0031afb68bf959a5ca13b100e4528971e3ba58c0"},{"author":{"_account_id":6994,"name":"Michael Chapman","email":"woppin@gmail.com","username":"michaeltchapman"},"change_message_id":"6697b2c42d5b4550ca3bbad3807ad8cd3a8e80d7","unresolved":false,"context_lines":[{"line_number":27,"context_line":"you can both create zones and recordsets in batches and move zones out of"},{"line_number":28,"context_line":"Designate easily."},{"line_number":29,"context_line":""},{"line_number":30,"context_line":"Zone Export"},{"line_number":31,"context_line":"\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d"},{"line_number":32,"context_line":""},{"line_number":33,"context_line":"You can export a zone file from Designate using the `zone export create`"}],"source_content_type":"text/x-rst","patch_set":3,"id":"888aaff5_34e83c4a","line":30,"range":{"start_line":30,"start_character":0,"end_line":30,"end_character":11},"in_reply_to":"accd438f_f504daca","updated":"2021-07-21 01:08:54.000000000","message":"Done","commit_id":"0031afb68bf959a5ca13b100e4528971e3ba58c0"},{"author":{"_account_id":31933,"name":"Greg Rakauskas","display_name":"Greg Rakauskas","email":"gregraka@redhat.com","username":"gregraka"},"change_message_id":"e8de13a80fe71842205bef61dfa8dba3c8bd32cc","unresolved":true,"context_lines":[{"line_number":33,"context_line":"You can export a zone file from Designate using the `zone export create`"},{"line_number":34,"context_line":"subcommand on an existing zone. The zone export resource created does not"},{"line_number":35,"context_line":"contain the zone file data, instead it holds the location of that data as"},{"line_number":36,"context_line":"designate can be configured to store zone exports in different ways."},{"line_number":37,"context_line":"You can view the location of the zone file using `zone export show`."},{"line_number":38,"context_line":"The protocol of \u0027designate\u0027 in the url indicates that the exported zone"},{"line_number":39,"context_line":"file is stored internally."}],"source_content_type":"text/x-rst","patch_set":3,"id":"5a1233f1_11ab64d9","line":36,"range":{"start_line":36,"start_character":53,"end_line":36,"end_character":67},"updated":"2021-07-02 18:48:36.000000000","message":"Do we describe somewhere what these different ways are?","commit_id":"0031afb68bf959a5ca13b100e4528971e3ba58c0"},{"author":{"_account_id":31933,"name":"Greg Rakauskas","display_name":"Greg Rakauskas","email":"gregraka@redhat.com","username":"gregraka"},"change_message_id":"e8de13a80fe71842205bef61dfa8dba3c8bd32cc","unresolved":true,"context_lines":[{"line_number":33,"context_line":"You can export a zone file from Designate using the `zone export create`"},{"line_number":34,"context_line":"subcommand on an existing zone. The zone export resource created does not"},{"line_number":35,"context_line":"contain the zone file data, instead it holds the location of that data as"},{"line_number":36,"context_line":"designate can be configured to store zone exports in different ways."},{"line_number":37,"context_line":"You can view the location of the zone file using `zone export show`."},{"line_number":38,"context_line":"The protocol of \u0027designate\u0027 in the url indicates that the exported zone"},{"line_number":39,"context_line":"file is stored internally."}],"source_content_type":"text/x-rst","patch_set":3,"id":"392dd2ff_ca5c4c65","line":36,"range":{"start_line":36,"start_character":0,"end_line":36,"end_character":9},"updated":"2021-07-02 18:48:36.000000000","message":"Should \u0027designate\u0027 be capitalized? Not sure.","commit_id":"0031afb68bf959a5ca13b100e4528971e3ba58c0"},{"author":{"_account_id":6994,"name":"Michael Chapman","email":"woppin@gmail.com","username":"michaeltchapman"},"change_message_id":"6697b2c42d5b4550ca3bbad3807ad8cd3a8e80d7","unresolved":false,"context_lines":[{"line_number":33,"context_line":"You can export a zone file from Designate using the `zone export create`"},{"line_number":34,"context_line":"subcommand on an existing zone. The zone export resource created does not"},{"line_number":35,"context_line":"contain the zone file data, instead it holds the location of that data as"},{"line_number":36,"context_line":"designate can be configured to store zone exports in different ways."},{"line_number":37,"context_line":"You can view the location of the zone file using `zone export show`."},{"line_number":38,"context_line":"The protocol of \u0027designate\u0027 in the url indicates that the exported zone"},{"line_number":39,"context_line":"file is stored internally."}],"source_content_type":"text/x-rst","patch_set":3,"id":"3b07fa09_ada57435","line":36,"range":{"start_line":36,"start_character":0,"end_line":36,"end_character":9},"in_reply_to":"392dd2ff_ca5c4c65","updated":"2021-07-21 01:08:54.000000000","message":"Done","commit_id":"0031afb68bf959a5ca13b100e4528971e3ba58c0"},{"author":{"_account_id":31933,"name":"Greg Rakauskas","display_name":"Greg Rakauskas","email":"gregraka@redhat.com","username":"gregraka"},"change_message_id":"e8de13a80fe71842205bef61dfa8dba3c8bd32cc","unresolved":true,"context_lines":[{"line_number":35,"context_line":"contain the zone file data, instead it holds the location of that data as"},{"line_number":36,"context_line":"designate can be configured to store zone exports in different ways."},{"line_number":37,"context_line":"You can view the location of the zone file using `zone export show`."},{"line_number":38,"context_line":"The protocol of \u0027designate\u0027 in the url indicates that the exported zone"},{"line_number":39,"context_line":"file is stored internally."},{"line_number":40,"context_line":""},{"line_number":41,"context_line":".. code-block:: console"},{"line_number":42,"context_line":""}],"source_content_type":"text/x-rst","patch_set":3,"id":"f4d3a796_317327a5","line":39,"range":{"start_line":38,"start_character":0,"end_line":39,"end_character":26},"updated":"2021-07-02 18:48:36.000000000","message":"I don\u0027t understand this. How does one determine the protocol of designate in the URL? And, how does one know which protocols indicate that the file is stored internally?","commit_id":"0031afb68bf959a5ca13b100e4528971e3ba58c0"},{"author":{"_account_id":6994,"name":"Michael Chapman","email":"woppin@gmail.com","username":"michaeltchapman"},"change_message_id":"6697b2c42d5b4550ca3bbad3807ad8cd3a8e80d7","unresolved":true,"context_lines":[{"line_number":35,"context_line":"contain the zone file data, instead it holds the location of that data as"},{"line_number":36,"context_line":"designate can be configured to store zone exports in different ways."},{"line_number":37,"context_line":"You can view the location of the zone file using `zone export show`."},{"line_number":38,"context_line":"The protocol of \u0027designate\u0027 in the url indicates that the exported zone"},{"line_number":39,"context_line":"file is stored internally."},{"line_number":40,"context_line":""},{"line_number":41,"context_line":".. code-block:: console"},{"line_number":42,"context_line":""}],"source_content_type":"text/x-rst","patch_set":3,"id":"edae589c_33379a1f","line":39,"range":{"start_line":38,"start_character":0,"end_line":39,"end_character":26},"in_reply_to":"f4d3a796_317327a5","updated":"2021-07-21 01:08:54.000000000","message":"I\u0027ve moved this explanation to the end because it\u0027s not really important. I found the design confusing and wanted to explain it as a result:\n - The zone file can be stored using different backends\n - The location will be a url and is visible on the export resource\n - The default backend has a protocol of designate:// in the url\n - There is actually only one backend implementation and that\u0027s the default one\n - it doesn\u0027t actually store the files, it generates them on demand.\n\nI think it was originally designed to put the zone files in swift or something, but it never happened because it\u0027s such a rare issue for zone files to be that big.","commit_id":"0031afb68bf959a5ca13b100e4528971e3ba58c0"},{"author":{"_account_id":31933,"name":"Greg Rakauskas","display_name":"Greg Rakauskas","email":"gregraka@redhat.com","username":"gregraka"},"change_message_id":"e8de13a80fe71842205bef61dfa8dba3c8bd32cc","unresolved":true,"context_lines":[{"line_number":40,"context_line":""},{"line_number":41,"context_line":".. code-block:: console"},{"line_number":42,"context_line":""},{"line_number":43,"context_line":"  $ openstack recordset list example.org."},{"line_number":44,"context_line":"  +--------------------------------------+------------------+------+---------------------------------------------------------------------+--------+--------+"},{"line_number":45,"context_line":"  | id                                   | name             | type | records                                                             | status | action |"},{"line_number":46,"context_line":"  +--------------------------------------+------------------+------+---------------------------------------------------------------------+--------+--------+"}],"source_content_type":"text/x-rst","patch_set":3,"id":"33a2d839_f0d83082","line":43,"range":{"start_line":43,"start_character":1,"end_line":43,"end_character":3},"updated":"2021-07-02 18:48:36.000000000","message":"I\u0027m befuddled why there are several command examples here. The title of the section is \"Zone Export,\" so I expect to see the example to use the `zone export create` command. But instead, I first see `openstack recordset list`. Why is that? Perhaps more explanation is needed.\n\nI\u0027m thinking of something like this. (I might not be correct, but you get the idea. :^) :\n\n1. Run the `openstack recordset list` to confirm the name of the recordset that you want to export as a zone:\n\n  $ openstack recordset list example.org.\n\n2. Using the `openstack zone export create` command, export `example.org`:\n\n  $ openstack zone export create example.org.\n\n3. Using the zone ID, run the `openstack zone export show` command to identify the location of the exported zone file:\n\n  $ openstack zone export show e75aef2c-b562-4cd9-a426-4a73f6cb82be","commit_id":"0031afb68bf959a5ca13b100e4528971e3ba58c0"},{"author":{"_account_id":6994,"name":"Michael Chapman","email":"woppin@gmail.com","username":"michaeltchapman"},"change_message_id":"6697b2c42d5b4550ca3bbad3807ad8cd3a8e80d7","unresolved":false,"context_lines":[{"line_number":40,"context_line":""},{"line_number":41,"context_line":".. code-block:: console"},{"line_number":42,"context_line":""},{"line_number":43,"context_line":"  $ openstack recordset list example.org."},{"line_number":44,"context_line":"  +--------------------------------------+------------------+------+---------------------------------------------------------------------+--------+--------+"},{"line_number":45,"context_line":"  | id                                   | name             | type | records                                                             | status | action |"},{"line_number":46,"context_line":"  +--------------------------------------+------------------+------+---------------------------------------------------------------------+--------+--------+"}],"source_content_type":"text/x-rst","patch_set":3,"id":"78261d5d_ce07de13","line":43,"range":{"start_line":43,"start_character":1,"end_line":43,"end_character":3},"in_reply_to":"33a2d839_f0d83082","updated":"2021-07-21 01:08:54.000000000","message":"Done","commit_id":"0031afb68bf959a5ca13b100e4528971e3ba58c0"},{"author":{"_account_id":31933,"name":"Greg Rakauskas","display_name":"Greg Rakauskas","email":"gregraka@redhat.com","username":"gregraka"},"change_message_id":"e8de13a80fe71842205bef61dfa8dba3c8bd32cc","unresolved":true,"context_lines":[{"line_number":80,"context_line":""},{"line_number":81,"context_line":"You can access the contents of the zone file using `zone export showfile`."},{"line_number":82,"context_line":"Using the `-f value` parameter will print the contents of the zone file without"},{"line_number":83,"context_line":"any tabulation, which can be useful if you want to save the zone file to"},{"line_number":84,"context_line":"reimport later."},{"line_number":85,"context_line":""},{"line_number":86,"context_line":".. code-block:: console"},{"line_number":87,"context_line":""}],"source_content_type":"text/x-rst","patch_set":3,"id":"b44fedee_f90bbff7","line":84,"range":{"start_line":83,"start_character":16,"end_line":84,"end_character":15},"updated":"2021-07-02 18:48:36.000000000","message":"Hmmm... couple of questions here:\n\nA. Isn\u0027t the zone file already saved? \n\nB. So, the zone file that has been exported has \u0027tabulation?\u0027 What exactly is that? Is it a file that includes embedded tab characters? Why does having a file w/o tabulation matter?\n\nC. Do we explain how to print w/o tabulation and then save?","commit_id":"0031afb68bf959a5ca13b100e4528971e3ba58c0"},{"author":{"_account_id":6994,"name":"Michael Chapman","email":"woppin@gmail.com","username":"michaeltchapman"},"change_message_id":"6697b2c42d5b4550ca3bbad3807ad8cd3a8e80d7","unresolved":true,"context_lines":[{"line_number":80,"context_line":""},{"line_number":81,"context_line":"You can access the contents of the zone file using `zone export showfile`."},{"line_number":82,"context_line":"Using the `-f value` parameter will print the contents of the zone file without"},{"line_number":83,"context_line":"any tabulation, which can be useful if you want to save the zone file to"},{"line_number":84,"context_line":"reimport later."},{"line_number":85,"context_line":""},{"line_number":86,"context_line":".. code-block:: console"},{"line_number":87,"context_line":""}],"source_content_type":"text/x-rst","patch_set":3,"id":"f06126c2_6c6dc9bd","line":84,"range":{"start_line":83,"start_character":16,"end_line":84,"end_character":15},"in_reply_to":"b44fedee_f90bbff7","updated":"2021-07-21 01:08:54.000000000","message":"A. Yes, I added that this is if you want to export-modify-import as a way of modifying the zone\nB. The tabulation is the dashes and whatnot around eg. Field and Value in the other openstack commands. Including this in the result doesn\u0027t result in a valid zone file. I don\u0027t think it\u0027s a good default but that\u0027s a bug for another day.\nC. It\u0027s the command below to print without tabulation. It\u0027s \u0027saving\u0027 a file on the local disk.","commit_id":"0031afb68bf959a5ca13b100e4528971e3ba58c0"},{"author":{"_account_id":31933,"name":"Greg Rakauskas","display_name":"Greg Rakauskas","email":"gregraka@redhat.com","username":"gregraka"},"change_message_id":"e8de13a80fe71842205bef61dfa8dba3c8bd32cc","unresolved":true,"context_lines":[{"line_number":95,"context_line":"  www.example.org.  IN A 192.0.2.2"},{"line_number":96,"context_line":"  www.example.org.  IN A 192.0.2.1"},{"line_number":97,"context_line":""},{"line_number":98,"context_line":"If the default designate storage scheme is used, the zone export file will be"},{"line_number":99,"context_line":"created on demand as it is accessed and as a result the contents of the zone"},{"line_number":100,"context_line":"export file will be updated as you add new recordsets to the zone:"},{"line_number":101,"context_line":""},{"line_number":102,"context_line":".. code-block:: console"},{"line_number":103,"context_line":""}],"source_content_type":"text/x-rst","patch_set":3,"id":"b1161fa7_018443ca","line":100,"range":{"start_line":98,"start_character":0,"end_line":100,"end_character":66},"updated":"2021-07-02 18:48:36.000000000","message":"I don\u0027t understand this sentence.\n\nAre you trying to say the following?\n\nBy default, designate automatically creates a zone export file whenever you create a zone. When you modify the zone, designate automatically updates the zone export file to reflect your changes.\n\nQuestions:\nA. What is the advantage of having a zone export file automatically created when you create the zone?\n\nB. Do we describe in another section how to change the default storage schema?\n\nC. Why might a person want to use another schema?","commit_id":"0031afb68bf959a5ca13b100e4528971e3ba58c0"},{"author":{"_account_id":6994,"name":"Michael Chapman","email":"woppin@gmail.com","username":"michaeltchapman"},"change_message_id":"6697b2c42d5b4550ca3bbad3807ad8cd3a8e80d7","unresolved":true,"context_lines":[{"line_number":95,"context_line":"  www.example.org.  IN A 192.0.2.2"},{"line_number":96,"context_line":"  www.example.org.  IN A 192.0.2.1"},{"line_number":97,"context_line":""},{"line_number":98,"context_line":"If the default designate storage scheme is used, the zone export file will be"},{"line_number":99,"context_line":"created on demand as it is accessed and as a result the contents of the zone"},{"line_number":100,"context_line":"export file will be updated as you add new recordsets to the zone:"},{"line_number":101,"context_line":""},{"line_number":102,"context_line":".. code-block:: console"},{"line_number":103,"context_line":""}],"source_content_type":"text/x-rst","patch_set":3,"id":"689ba0bc_83a9a16e","line":100,"range":{"start_line":98,"start_character":0,"end_line":100,"end_character":66},"in_reply_to":"b1161fa7_018443ca","updated":"2021-07-21 01:08:54.000000000","message":"I think I covered this in another answer.","commit_id":"0031afb68bf959a5ca13b100e4528971e3ba58c0"},{"author":{"_account_id":31933,"name":"Greg Rakauskas","display_name":"Greg Rakauskas","email":"gregraka@redhat.com","username":"gregraka"},"change_message_id":"e8de13a80fe71842205bef61dfa8dba3c8bd32cc","unresolved":true,"context_lines":[{"line_number":133,"context_line":"Zone Import"},{"line_number":134,"context_line":"\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d"},{"line_number":135,"context_line":""},{"line_number":136,"context_line":"You can import a zone and all of its recordsets by putting them all into a"},{"line_number":137,"context_line":"single zone file that uses the `zone file format`_:"},{"line_number":138,"context_line":""},{"line_number":139,"context_line":".. code-block:: console"}],"source_content_type":"text/x-rst","patch_set":3,"id":"86eb6e9f_42f542d2","line":136,"range":{"start_line":136,"start_character":0,"end_line":136,"end_character":1},"updated":"2021-07-02 18:48:36.000000000","message":"Questions:\n\nA. Can a \u0027single zone file\u0027 be created by exporting a zone? \n\nB. So, a zone consists of recordsets? Is it important to write \u0027a zone and all of its recordsets\u0027 instead of just writing \u0027a zone?\u0027\n\nC. Do we describe `zone file format` somewhere? If not, should we?\n\nD. What are the variables, $ORIGIN and $TTL? I suppose most designate users/admins know what these are, or should we explain them?","commit_id":"0031afb68bf959a5ca13b100e4528971e3ba58c0"},{"author":{"_account_id":6994,"name":"Michael Chapman","email":"woppin@gmail.com","username":"michaeltchapman"},"change_message_id":"6697b2c42d5b4550ca3bbad3807ad8cd3a8e80d7","unresolved":true,"context_lines":[{"line_number":133,"context_line":"Zone Import"},{"line_number":134,"context_line":"\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d"},{"line_number":135,"context_line":""},{"line_number":136,"context_line":"You can import a zone and all of its recordsets by putting them all into a"},{"line_number":137,"context_line":"single zone file that uses the `zone file format`_:"},{"line_number":138,"context_line":""},{"line_number":139,"context_line":".. code-block:: console"}],"source_content_type":"text/x-rst","patch_set":3,"id":"b341cefe_c8600bf4","line":136,"range":{"start_line":136,"start_character":0,"end_line":136,"end_character":1},"in_reply_to":"86eb6e9f_42f542d2","updated":"2021-07-21 01:08:54.000000000","message":"A. Yes\nB. Correct, I spelled it out since they\u0027re 2 different resources in Designate\nC. It\u0027s a link to the wikipedia page describing the format, which is an RFC.\nD. They\u0027re part of the zone file format.","commit_id":"0031afb68bf959a5ca13b100e4528971e3ba58c0"},{"author":{"_account_id":31933,"name":"Greg Rakauskas","display_name":"Greg Rakauskas","email":"gregraka@redhat.com","username":"gregraka"},"change_message_id":"e8de13a80fe71842205bef61dfa8dba3c8bd32cc","unresolved":true,"context_lines":[{"line_number":216,"context_line":"  | f97274f1-e062-4f59-8ec0-11bccd830547 | test.example.org. | A    | 192.0.2.100                                                         | ACTIVE | NONE   |"},{"line_number":217,"context_line":"  +--------------------------------------+-------------------+------+---------------------------------------------------------------------+--------+--------+"},{"line_number":218,"context_line":""},{"line_number":219,"context_line":"The TTL for the zone must be set using a TTL statement in the zone file."},{"line_number":220,"context_line":"The SOA record created for the zone will not always match the values in the"},{"line_number":221,"context_line":"zone file since some values are dependent on Designate configuration options:"},{"line_number":222,"context_line":""}],"source_content_type":"text/x-rst","patch_set":3,"id":"69f5690f_8b59a5fe","line":219,"range":{"start_line":219,"start_character":4,"end_line":219,"end_character":7},"updated":"2021-07-02 18:48:36.000000000","message":"Is this \u0027time to live?\u0027 Typically, we spell out abbreviations on their first use, unless the abbrev is super obvious like IP. This might be a question of my ignorance! 😮","commit_id":"0031afb68bf959a5ca13b100e4528971e3ba58c0"},{"author":{"_account_id":31933,"name":"Greg Rakauskas","display_name":"Greg Rakauskas","email":"gregraka@redhat.com","username":"gregraka"},"change_message_id":"e8de13a80fe71842205bef61dfa8dba3c8bd32cc","unresolved":true,"context_lines":[{"line_number":216,"context_line":"  | f97274f1-e062-4f59-8ec0-11bccd830547 | test.example.org. | A    | 192.0.2.100                                                         | ACTIVE | NONE   |"},{"line_number":217,"context_line":"  +--------------------------------------+-------------------+------+---------------------------------------------------------------------+--------+--------+"},{"line_number":218,"context_line":""},{"line_number":219,"context_line":"The TTL for the zone must be set using a TTL statement in the zone file."},{"line_number":220,"context_line":"The SOA record created for the zone will not always match the values in the"},{"line_number":221,"context_line":"zone file since some values are dependent on Designate configuration options:"},{"line_number":222,"context_line":""}],"source_content_type":"text/x-rst","patch_set":3,"id":"2be6c05f_dcaeb658","line":219,"range":{"start_line":219,"start_character":8,"end_line":219,"end_character":21},"updated":"2021-07-02 18:48:36.000000000","message":"So, if you want to set the TTL for a zone that you are creating through a zone file, you manually add the `TTL` setting to the zone file? Do you have the option of setting the TTL after the zone has been created?","commit_id":"0031afb68bf959a5ca13b100e4528971e3ba58c0"},{"author":{"_account_id":31933,"name":"Greg Rakauskas","display_name":"Greg Rakauskas","email":"gregraka@redhat.com","username":"gregraka"},"change_message_id":"e8de13a80fe71842205bef61dfa8dba3c8bd32cc","unresolved":true,"context_lines":[{"line_number":216,"context_line":"  | f97274f1-e062-4f59-8ec0-11bccd830547 | test.example.org. | A    | 192.0.2.100                                                         | ACTIVE | NONE   |"},{"line_number":217,"context_line":"  +--------------------------------------+-------------------+------+---------------------------------------------------------------------+--------+--------+"},{"line_number":218,"context_line":""},{"line_number":219,"context_line":"The TTL for the zone must be set using a TTL statement in the zone file."},{"line_number":220,"context_line":"The SOA record created for the zone will not always match the values in the"},{"line_number":221,"context_line":"zone file since some values are dependent on Designate configuration options:"},{"line_number":222,"context_line":""}],"source_content_type":"text/x-rst","patch_set":3,"id":"44c40364_026fca29","line":219,"range":{"start_line":219,"start_character":0,"end_line":219,"end_character":3},"updated":"2021-07-02 18:48:36.000000000","message":"Suggest that you rewrite this sentence in active voice:\n\n  You must set the zone TTL using a TTL statement in the zone file.","commit_id":"0031afb68bf959a5ca13b100e4528971e3ba58c0"},{"author":{"_account_id":6994,"name":"Michael Chapman","email":"woppin@gmail.com","username":"michaeltchapman"},"change_message_id":"6697b2c42d5b4550ca3bbad3807ad8cd3a8e80d7","unresolved":true,"context_lines":[{"line_number":216,"context_line":"  | f97274f1-e062-4f59-8ec0-11bccd830547 | test.example.org. | A    | 192.0.2.100                                                         | ACTIVE | NONE   |"},{"line_number":217,"context_line":"  +--------------------------------------+-------------------+------+---------------------------------------------------------------------+--------+--------+"},{"line_number":218,"context_line":""},{"line_number":219,"context_line":"The TTL for the zone must be set using a TTL statement in the zone file."},{"line_number":220,"context_line":"The SOA record created for the zone will not always match the values in the"},{"line_number":221,"context_line":"zone file since some values are dependent on Designate configuration options:"},{"line_number":222,"context_line":""}],"source_content_type":"text/x-rst","patch_set":3,"id":"eb7092ee_d86a3fd6","line":219,"range":{"start_line":219,"start_character":4,"end_line":219,"end_character":7},"in_reply_to":"69f5690f_8b59a5fe","updated":"2021-07-21 01:08:54.000000000","message":"Yep it\u0027s time to live. I\u0027m not spelling out abbreviations that are covered in the intro doc or the managing records/zones docs because I see them as assumed knowledge once the user gets to import/export, but if that\u0027s not reasonable I can spell them out on each doc page.","commit_id":"0031afb68bf959a5ca13b100e4528971e3ba58c0"},{"author":{"_account_id":31933,"name":"Greg Rakauskas","display_name":"Greg Rakauskas","email":"gregraka@redhat.com","username":"gregraka"},"change_message_id":"e8de13a80fe71842205bef61dfa8dba3c8bd32cc","unresolved":true,"context_lines":[{"line_number":217,"context_line":"  +--------------------------------------+-------------------+------+---------------------------------------------------------------------+--------+--------+"},{"line_number":218,"context_line":""},{"line_number":219,"context_line":"The TTL for the zone must be set using a TTL statement in the zone file."},{"line_number":220,"context_line":"The SOA record created for the zone will not always match the values in the"},{"line_number":221,"context_line":"zone file since some values are dependent on Designate configuration options:"},{"line_number":222,"context_line":""},{"line_number":223,"context_line":"- The `MNAME` is set using the zone\u0027s assigned pool information"}],"source_content_type":"text/x-rst","patch_set":3,"id":"df815d99_ad6fd1b4","line":220,"range":{"start_line":220,"start_character":4,"end_line":220,"end_character":7},"updated":"2021-07-02 18:48:36.000000000","message":"Spell out abbreviation?","commit_id":"0031afb68bf959a5ca13b100e4528971e3ba58c0"},{"author":{"_account_id":31933,"name":"Greg Rakauskas","display_name":"Greg Rakauskas","email":"gregraka@redhat.com","username":"gregraka"},"change_message_id":"e8de13a80fe71842205bef61dfa8dba3c8bd32cc","unresolved":true,"context_lines":[{"line_number":218,"context_line":""},{"line_number":219,"context_line":"The TTL for the zone must be set using a TTL statement in the zone file."},{"line_number":220,"context_line":"The SOA record created for the zone will not always match the values in the"},{"line_number":221,"context_line":"zone file since some values are dependent on Designate configuration options:"},{"line_number":222,"context_line":""},{"line_number":223,"context_line":"- The `MNAME` is set using the zone\u0027s assigned pool information"},{"line_number":224,"context_line":"- The refresh value is set randomly between the ``default_soa_refresh_min``"}],"source_content_type":"text/x-rst","patch_set":3,"id":"f246642d_740abed4","line":221,"range":{"start_line":221,"start_character":10,"end_line":221,"end_character":15},"updated":"2021-07-02 18:48:36.000000000","message":"Instead of \u0027since\u0027 use \u0027because\u0027.\n\nStyle Guide: \"To facilitate translation, use \u0027since\u0027 to refer only to time. Do not use it as a synonym for \"because\".\"","commit_id":"0031afb68bf959a5ca13b100e4528971e3ba58c0"},{"author":{"_account_id":31933,"name":"Greg Rakauskas","display_name":"Greg Rakauskas","email":"gregraka@redhat.com","username":"gregraka"},"change_message_id":"e8de13a80fe71842205bef61dfa8dba3c8bd32cc","unresolved":true,"context_lines":[{"line_number":220,"context_line":"The SOA record created for the zone will not always match the values in the"},{"line_number":221,"context_line":"zone file since some values are dependent on Designate configuration options:"},{"line_number":222,"context_line":""},{"line_number":223,"context_line":"- The `MNAME` is set using the zone\u0027s assigned pool information"},{"line_number":224,"context_line":"- The refresh value is set randomly between the ``default_soa_refresh_min``"},{"line_number":225,"context_line":"  and ``default_soa_refresh_max`` configuration values."},{"line_number":226,"context_line":"- The minimum value is set to the ``soa_default_minimum`` configuration value."}],"source_content_type":"text/x-rst","patch_set":3,"id":"4a129320_2d0e2c03","line":223,"range":{"start_line":223,"start_character":62,"end_line":223,"end_character":63},"updated":"2021-07-02 18:48:36.000000000","message":"Missing a period (full stop).","commit_id":"0031afb68bf959a5ca13b100e4528971e3ba58c0"},{"author":{"_account_id":31933,"name":"Greg Rakauskas","display_name":"Greg Rakauskas","email":"gregraka@redhat.com","username":"gregraka"},"change_message_id":"e8de13a80fe71842205bef61dfa8dba3c8bd32cc","unresolved":true,"context_lines":[{"line_number":220,"context_line":"The SOA record created for the zone will not always match the values in the"},{"line_number":221,"context_line":"zone file since some values are dependent on Designate configuration options:"},{"line_number":222,"context_line":""},{"line_number":223,"context_line":"- The `MNAME` is set using the zone\u0027s assigned pool information"},{"line_number":224,"context_line":"- The refresh value is set randomly between the ``default_soa_refresh_min``"},{"line_number":225,"context_line":"  and ``default_soa_refresh_max`` configuration values."},{"line_number":226,"context_line":"- The minimum value is set to the ``soa_default_minimum`` configuration value."}],"source_content_type":"text/x-rst","patch_set":3,"id":"ca8cd9d3_6f9f0c5e","line":223,"range":{"start_line":223,"start_character":2,"end_line":223,"end_character":5},"updated":"2021-07-02 18:48:36.000000000","message":"Perhaps a table would be appropriate here?\n\n-----------------------------------------------\nValue of         Set by Designate \nzone file field  configuration option\n---------------  ------------------------------\nMNAME            Zone assigned pool**\n---------------  ------------------------------\nrefresh value**  Random value between\n                 ``default_soa_refresh_min``\n                 and ``default_soa_refresh_max``\n---------------  ------------------------------\nmin value**      ``soa_default_minimum``\n-----------------------------------------------\n\n** Do these values have a field name (like MNAME)?","commit_id":"0031afb68bf959a5ca13b100e4528971e3ba58c0"},{"author":{"_account_id":31933,"name":"Greg Rakauskas","display_name":"Greg Rakauskas","email":"gregraka@redhat.com","username":"gregraka"},"change_message_id":"e8de13a80fe71842205bef61dfa8dba3c8bd32cc","unresolved":true,"context_lines":[{"line_number":226,"context_line":"- The minimum value is set to the ``soa_default_minimum`` configuration value."},{"line_number":227,"context_line":""},{"line_number":228,"context_line":"The NS record for the zone is generated based on the pool the zone has been"},{"line_number":229,"context_line":"assigned. Other NS records will import normally."},{"line_number":230,"context_line":""},{"line_number":231,"context_line":"For example, the following zone file uses `test.example.org.` as its namserver,"},{"line_number":232,"context_line":"and provides its own values for the zone TTL, refresh, minimum and expire. The"}],"source_content_type":"text/x-rst","patch_set":3,"id":"0295873f_b8178020","line":229,"range":{"start_line":229,"start_character":10,"end_line":229,"end_character":48},"updated":"2021-07-02 18:48:36.000000000","message":"To me, this sentence seems vague.\n\nAre there multiple records in a zone? One for the zone itself and additional records? If so, then perhaps rewrite this paragraph to read:\n\n\"Designate generates the zone nameserver (NS) record based on the pool to which the zone is assigned. Other records in the zone are imported based on their assigned nameservers.\"\n\n(Don\u0027t know if the second sentence is correct, it\u0027s just a guess.)","commit_id":"0031afb68bf959a5ca13b100e4528971e3ba58c0"},{"author":{"_account_id":6994,"name":"Michael Chapman","email":"woppin@gmail.com","username":"michaeltchapman"},"change_message_id":"6697b2c42d5b4550ca3bbad3807ad8cd3a8e80d7","unresolved":true,"context_lines":[{"line_number":226,"context_line":"- The minimum value is set to the ``soa_default_minimum`` configuration value."},{"line_number":227,"context_line":""},{"line_number":228,"context_line":"The NS record for the zone is generated based on the pool the zone has been"},{"line_number":229,"context_line":"assigned. Other NS records will import normally."},{"line_number":230,"context_line":""},{"line_number":231,"context_line":"For example, the following zone file uses `test.example.org.` as its namserver,"},{"line_number":232,"context_line":"and provides its own values for the zone TTL, refresh, minimum and expire. The"}],"source_content_type":"text/x-rst","patch_set":3,"id":"26ec0774_7d6fccb1","line":229,"range":{"start_line":229,"start_character":10,"end_line":229,"end_character":48},"in_reply_to":"0295873f_b8178020","updated":"2021-07-21 01:08:54.000000000","message":"The zone itself is essentially two records: the SOA and an NS record that points to the designate Bind9 servers. This doesn\u0027t preclude users from creating other NS records within their zone, just that the zone itself won\u0027t work unless it says where its servers are.","commit_id":"0031afb68bf959a5ca13b100e4528971e3ba58c0"},{"author":{"_account_id":11628,"name":"Michael Johnson","email":"johnsomor@gmail.com","username":"johnsom"},"change_message_id":"4150410b49554399bac90dfbd313e8a15f36d7bc","unresolved":true,"context_lines":[{"line_number":125,"context_line":""},{"line_number":126,"context_line":"The zone export resource created does not contain the zone file data, instead"},{"line_number":127,"context_line":"it holds the location of that data as Designate can be configured by the"},{"line_number":128,"context_line":"operator to store zone exports in external services. By default, the location"},{"line_number":129,"context_line":"in the zone export file is internal to Designate uses the Designate protocol"},{"line_number":130,"context_line":"`designate://`. In this case, zone file data will be generated on demand when"},{"line_number":131,"context_line":"`zone export showfile` is used. You can view the location of the zone file"},{"line_number":132,"context_line":"data using `zone export show`:"},{"line_number":133,"context_line":""}],"source_content_type":"text/x-rst","patch_set":5,"id":"3b6f4ca5_4625e064","line":130,"range":{"start_line":128,"start_character":53,"end_line":130,"end_character":14},"updated":"2021-09-10 20:48:04.000000000","message":"This sentence is a bit awkward. We should reword it.","commit_id":"696f0bcc125f629e2c920fcf665507e1dd033fe3"}]}