)]}'
{"guidelines/time.rst":[{"author":{"_account_id":10670,"name":"Michael McCune","email":"elmiko@redhat.com","username":"mimccune"},"change_message_id":"0276a4ddc416a13638947035e472731080d62105","unresolved":false,"context_lines":[{"line_number":8,"context_line":"--------"},{"line_number":9,"context_line":""},{"line_number":10,"context_line":"* To avoid the difference with time zones we recommend to use the UTC timezone"},{"line_number":11,"context_line":"  in REST API."},{"line_number":12,"context_line":""},{"line_number":13,"context_line":"Why You Should Use UTC?"},{"line_number":14,"context_line":"-----------------------"}],"source_content_type":"text/x-rst","patch_set":3,"id":"ba7be1f8_d8e0a7ce","line":11,"updated":"2015-03-02 16:43:19.000000000","message":"i think this would read a little better as:\n\n    To avoid differences in time zones we recommend the use of Coordinated Universal Time (UTC).","commit_id":"2be0e766ae9a16b2aee4921f68b88eeb7fd329d3"},{"author":{"_account_id":10670,"name":"Michael McCune","email":"elmiko@redhat.com","username":"mimccune"},"change_message_id":"0276a4ddc416a13638947035e472731080d62105","unresolved":false,"context_lines":[{"line_number":13,"context_line":"Why You Should Use UTC?"},{"line_number":14,"context_line":"-----------------------"},{"line_number":15,"context_line":"Coordinated Universal Time (aka UTC) is the standard international time that"},{"line_number":16,"context_line":"all time zones are expressed as offsets of. The primary advantage of storing"},{"line_number":17,"context_line":"date/time values in UTC is that the data is no longer tied to a particular"},{"line_number":18,"context_line":"time zone. The current UTC will be the same regardless of the system\u0027s time"},{"line_number":19,"context_line":"zone. For more information see:"}],"source_content_type":"text/x-rst","patch_set":3,"id":"ba7be1f8_9801cf08","line":16,"updated":"2015-03-02 16:43:19.000000000","message":"i think the first sentence reads a little odd, maybe something like:\n\n    Coordinated Universal Time (UTC) is the primary time standard, all time zones can be expressed as positive or negative offsets from this time.","commit_id":"2be0e766ae9a16b2aee4921f68b88eeb7fd329d3"},{"author":{"_account_id":10559,"name":"Steven Kaufer","email":"kaufer@us.ibm.com","username":"kaufer"},"change_message_id":"6315a4291157e1c88a80c44675396febb2b4192b","unresolved":false,"context_lines":[{"line_number":7,"context_line":"REST API"},{"line_number":8,"context_line":"--------"},{"line_number":9,"context_line":""},{"line_number":10,"context_line":"* To avoid differences in time zones we recommend the use of Coordinated"},{"line_number":11,"context_line":"  Universal Time (UTC)."},{"line_number":12,"context_line":"* We recommend the date and time in ISO 8601 format for dates returned by"},{"line_number":13,"context_line":"  an API."}],"source_content_type":"text/x-rst","patch_set":6,"id":"9a80dd14_c1cebd59","line":10,"updated":"2015-03-13 15:07:43.000000000","message":"nit: Please try and avoid using \"we\" in the guideline docs. Same comment for the bullet below.","commit_id":"9ab52bf29b7d2adf46d5485de64f1ab58fe9b8e9"},{"author":{"_account_id":10559,"name":"Steven Kaufer","email":"kaufer@us.ibm.com","username":"kaufer"},"change_message_id":"f2fb2c6d56fa9e863f6df437cfdbb31d825f430e","unresolved":false,"context_lines":[{"line_number":1,"context_line":"Date and Time Conventions"},{"line_number":2,"context_line":"\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d"},{"line_number":3,"context_line":""},{"line_number":4,"context_line":"This topic document serves to provide guidance on how to use date and time"},{"line_number":5,"context_line":"format in OpenStack public REST APIs."},{"line_number":6,"context_line":""},{"line_number":7,"context_line":"REST API"}],"source_content_type":"text/x-rst","patch_set":7,"id":"9a80dd14_4503b80f","line":4,"updated":"2015-03-13 15:40:22.000000000","message":"How about: \n\n- ... to provide guidance on how to format dates and times in the OpenStack public REST APIs.","commit_id":"1aaefdfa3d781caf2bd0874aa994aba780d56db9"},{"author":{"_account_id":10559,"name":"Steven Kaufer","email":"kaufer@us.ibm.com","username":"kaufer"},"change_message_id":"f2fb2c6d56fa9e863f6df437cfdbb31d825f430e","unresolved":false,"context_lines":[{"line_number":7,"context_line":"REST API"},{"line_number":8,"context_line":"--------"},{"line_number":9,"context_line":""},{"line_number":10,"context_line":"* To avoid differences in time zones it is recommended the use of Coordinated"},{"line_number":11,"context_line":"  Universal Time (UTC)."},{"line_number":12,"context_line":"* It is recommended to use the date and time in ISO 8601 format for dates"},{"line_number":13,"context_line":"  returned by an API."}],"source_content_type":"text/x-rst","patch_set":7,"id":"9a80dd14_6548bcb3","line":10,"updated":"2015-03-13 15:40:22.000000000","message":"How about:\n\n- To avoid differences in time zones, the use of Coordinated Universal Time (UTC) is recommended.  See [1]_ for more information on UTC.\n\nWhere [1] would be a link to the wiki page you have below.","commit_id":"1aaefdfa3d781caf2bd0874aa994aba780d56db9"},{"author":{"_account_id":10559,"name":"Steven Kaufer","email":"kaufer@us.ibm.com","username":"kaufer"},"change_message_id":"f2fb2c6d56fa9e863f6df437cfdbb31d825f430e","unresolved":false,"context_lines":[{"line_number":9,"context_line":""},{"line_number":10,"context_line":"* To avoid differences in time zones it is recommended the use of Coordinated"},{"line_number":11,"context_line":"  Universal Time (UTC)."},{"line_number":12,"context_line":"* It is recommended to use the date and time in ISO 8601 format for dates"},{"line_number":13,"context_line":"  returned by an API."},{"line_number":14,"context_line":""},{"line_number":15,"context_line":"Why You Should Use UTC?"}],"source_content_type":"text/x-rst","patch_set":7,"id":"9a80dd14_e811e104","line":12,"updated":"2015-03-13 15:40:22.000000000","message":"I\u0027m not sure if we need the \"for dates returned by an API\" suffix on this bullet since the API scope of this doc has already been defined.\n\nHow about simplifying this to:\n\n- It is recommended to use the ISO 8601 format, see [2]_.\n\nWhere [2] would like to something like http://en.wikipedia.org/wiki/ISO_8601","commit_id":"1aaefdfa3d781caf2bd0874aa994aba780d56db9"},{"author":{"_account_id":10559,"name":"Steven Kaufer","email":"kaufer@us.ibm.com","username":"kaufer"},"change_message_id":"f2fb2c6d56fa9e863f6df437cfdbb31d825f430e","unresolved":false,"context_lines":[{"line_number":19,"context_line":"values in UTC is that the data is no longer tied to a particular time zone."},{"line_number":20,"context_line":"The current UTC will be the same regardless of the system\u0027s time zone."},{"line_number":21,"context_line":"For more information see:"},{"line_number":22,"context_line":"http://en.wikipedia.org/wiki/Coordinated_Universal_Time"}],"source_content_type":"text/x-rst","patch_set":7,"id":"9a80dd14_c8809dc1","line":22,"updated":"2015-03-13 15:40:22.000000000","message":"If you choose to implement the links above, you\u0027d put them here.  See https://review.openstack.org/#/c/162716/2/guidelines/counting.rst for an example of how to correctly link them with the ..[ref] notation.","commit_id":"1aaefdfa3d781caf2bd0874aa994aba780d56db9"},{"author":{"_account_id":10559,"name":"Steven Kaufer","email":"kaufer@us.ibm.com","username":"kaufer"},"change_message_id":"81fb1ec539bd219b09adbdd1d63c28d7e1db228d","unresolved":false,"context_lines":[{"line_number":1,"context_line":"Date and Time Conventions"},{"line_number":2,"context_line":"\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d"},{"line_number":3,"context_line":""},{"line_number":4,"context_line":"This topic document serves to provide guidance on how to format dates and time"},{"line_number":5,"context_line":"in the OpenStack public REST APIs."},{"line_number":6,"context_line":""},{"line_number":7,"context_line":"REST API"}],"source_content_type":"text/x-rst","patch_set":8,"id":"9a80dd14_aec0d150","line":4,"updated":"2015-03-13 16:10:30.000000000","message":"s/time/times","commit_id":"81ea4014fdb3cc481e717f3777151c04ea166141"},{"author":{"_account_id":12606,"name":"Miguel Grinberg","email":"miguel.grinberg@gmail.com","username":"miguelgrinberg"},"change_message_id":"91942965e256fe73323fed1407f22a17b190aa75","unresolved":false,"context_lines":[{"line_number":9,"context_line":""},{"line_number":10,"context_line":"* To avoid differences in time, the use of Coordinated Universal Time (UTC) is"},{"line_number":11,"context_line":"  recommended. For more information see [1]_."},{"line_number":12,"context_line":"* It is recommended to use the ISO 8601 format. For more information see [2]_."},{"line_number":13,"context_line":""},{"line_number":14,"context_line":"Why You Should Use UTC?"},{"line_number":15,"context_line":"-----------------------"}],"source_content_type":"text/x-rst","patch_set":9,"id":"9a80dd14_dcbcc408","line":12,"updated":"2015-03-14 06:52:55.000000000","message":"I find these two rules to be somewhat conflicting. In the first you recommend using UTC, but in the second you recommend using ISO8601, which is a format that is able to express any timezone consistently.\n\nHow about swapping the two recommendations as follows:\n\n- APIs should use ISO 8601 format to return dates and times in resource representations.\n- It is recommended that the UTC timezone is used.\n\nI also feel it is important to provide guidance on how the client should provide date and time information to the server. My suggestion is that you add a third recommendation:\n\n- Clients should also use the ISO 8601 format when providing dates to the server. The API server should be able to parse and interpret any valid ISO 8601 timestamp in any timezone.","commit_id":"70b2df4d00c207ae72c22c012979f002c94391a9"},{"author":{"_account_id":12606,"name":"Miguel Grinberg","email":"miguel.grinberg@gmail.com","username":"miguelgrinberg"},"change_message_id":"91942965e256fe73323fed1407f22a17b190aa75","unresolved":false,"context_lines":[{"line_number":16,"context_line":"UTC is the time standard, all time zones can be expressed as positive or"},{"line_number":17,"context_line":"negative offsets from this time. The primary advantage of storing date/time"},{"line_number":18,"context_line":"values in UTC is that the data is no longer tied to a particular time zone."},{"line_number":19,"context_line":"The current UTC will be the same regardless of the system\u0027s time zone."},{"line_number":20,"context_line":""},{"line_number":21,"context_line":".. [1] http://en.wikipedia.org/wiki/Coordinated_Universal_Time"},{"line_number":22,"context_line":".. [2] http://en.wikipedia.org/wiki/ISO_8601"}],"source_content_type":"text/x-rst","patch_set":9,"id":"9a80dd14_9c988cc1","line":19,"updated":"2015-03-14 06:52:55.000000000","message":"I feel this is recommending a server side implementation, but this guideline should be about how dates and times are represented in the API layer. I don\u0027t disagree with the advice, but I think this isn\u0027t the place for it.","commit_id":"70b2df4d00c207ae72c22c012979f002c94391a9"}]}