)]}'
{"/COMMIT_MSG":[{"author":{"_account_id":1063,"name":"Ed Leafe","email":"ed@leafe.com","username":"ed-leafe"},"change_message_id":"15fa8517115615353b7632d90354fc15f1213515","unresolved":false,"context_lines":[{"line_number":7,"context_line":"Add a guideline about use of the service catalog"},{"line_number":8,"context_line":""},{"line_number":9,"context_line":"The service catalog is an essential part of all API interactions,"},{"line_number":10,"context_line":"but it\u0027s use is largely freeform (or cargo-culted based on what\u0027s in"},{"line_number":11,"context_line":"devstack) Add specific guidlines for the catalogs of the future."},{"line_number":12,"context_line":""},{"line_number":13,"context_line":"Split out the information from the discoverability document that was"}],"source_content_type":"text/x-gerrit-commit-message","patch_set":1,"id":"7f96bb07_946255ad","line":10,"range":{"start_line":10,"start_character":4,"end_line":10,"end_character":9},"updated":"2018-01-18 15:36:42.000000000","message":"its","commit_id":"37a0df2d4a27dfd21e50634d4e1e0a84d75ea302"}],"guidelines/metadata.rst":[{"author":{"_account_id":8246,"name":"Qiming Teng","email":"tengqm@outlook.com","username":"tengqm"},"change_message_id":"d92e36a663de2d0750363ca0901d1d9a5ff8ae60","unresolved":false,"context_lines":[{"line_number":74,"context_line":"instead of a suffix)."},{"line_number":75,"context_line":""},{"line_number":76,"context_line":"For example, the resource identified by URL"},{"line_number":77,"context_line":"*https://compute.example.com/servers/1234567890* must expose its metadata with"},{"line_number":78,"context_line":"root URL *https://compute.example.com/servers/1234567890/metadata*."},{"line_number":79,"context_line":""},{"line_number":80,"context_line":"Obtaining Metadata"}],"source_content_type":"text/x-rst","patch_set":1,"id":"3f044301_2e73e9e9","line":77,"range":{"start_line":77,"start_character":1,"end_line":77,"end_character":29},"updated":"2017-05-04 08:53:28.000000000","message":"should this be https://api.example.com/compute to avoid misunderstanding?","commit_id":"37a0df2d4a27dfd21e50634d4e1e0a84d75ea302"}],"guidelines/service_catalog.rst":[{"author":{"_account_id":11564,"name":"Chris Dent","email":"cdent@anticdent.org","username":"chdent"},"change_message_id":"d1fc976441a8240cbd9a8cdf6e4647dd6051e909","unresolved":false,"context_lines":[{"line_number":36,"context_line":"Historically each of the OpenStack services were also given a port. It is"},{"line_number":37,"context_line":"strongly recommended to not use those ports and instead use the normal port"},{"line_number":38,"context_line":"443 for https. If multiple API services are to be installed on a single"},{"line_number":39,"context_line":"machine, it is highly recommended to use subpaths::"},{"line_number":40,"context_line":""},{"line_number":41,"context_line":"  https://api.example.com/compute"},{"line_number":42,"context_line":"  https://api.example.com/image"}],"source_content_type":"text/x-rst","patch_set":1,"id":"ff0f0b1f_336d8398","line":39,"updated":"2017-05-18 12:35:18.000000000","message":"If we\u0027re going ahead and giving guidance here, then we should probably be more explicit about the fact that \"api.example.com\" is mostly likely a multi-machine reverse proxy providing a single hostname to multiple load balanced backend web servers.\n\nSaying \"single machine\" might make the uninitiated think they can\u0027t get the pretty single hostname and prefixes in a robust install.","commit_id":"37a0df2d4a27dfd21e50634d4e1e0a84d75ea302"},{"author":{"_account_id":8246,"name":"Qiming Teng","email":"tengqm@outlook.com","username":"tengqm"},"change_message_id":"d92e36a663de2d0750363ca0901d1d9a5ff8ae60","unresolved":false,"context_lines":[{"line_number":44,"context_line":"The rationale behind this recommendation is to ease use for users who may have"},{"line_number":45,"context_line":"restrictive port-blocking firewalls in their operating environment. Since the"},{"line_number":46,"context_line":"traffic is HTTP traffic and not a different protocol, it is not necessary to"},{"line_number":47,"context_line":"distinguish it by port number, and doing so increases the chances that users"},{"line_number":48,"context_line":"will have problems connecting to individual API endpoints."},{"line_number":49,"context_line":""},{"line_number":50,"context_line":".. _service-type-registration:"}],"source_content_type":"text/x-rst","patch_set":1,"id":"3f044301_5112545a","line":47,"range":{"start_line":47,"start_character":44,"end_line":47,"end_character":53},"updated":"2017-05-04 08:53:28.000000000","message":"decreases ?","commit_id":"37a0df2d4a27dfd21e50634d4e1e0a84d75ea302"},{"author":{"_account_id":1063,"name":"Ed Leafe","email":"ed@leafe.com","username":"ed-leafe"},"change_message_id":"15fa8517115615353b7632d90354fc15f1213515","unresolved":false,"context_lines":[{"line_number":44,"context_line":"The rationale behind this recommendation is to ease use for users who may have"},{"line_number":45,"context_line":"restrictive port-blocking firewalls in their operating environment. Since the"},{"line_number":46,"context_line":"traffic is HTTP traffic and not a different protocol, it is not necessary to"},{"line_number":47,"context_line":"distinguish it by port number, and doing so increases the chances that users"},{"line_number":48,"context_line":"will have problems connecting to individual API endpoints."},{"line_number":49,"context_line":""},{"line_number":50,"context_line":".. _service-type-registration:"}],"source_content_type":"text/x-rst","patch_set":1,"id":"7f96bb07_94bed5d2","line":47,"range":{"start_line":47,"start_character":44,"end_line":47,"end_character":53},"in_reply_to":"3f044301_5112545a","updated":"2018-01-18 15:36:42.000000000","message":"The wording is awkward - \"doing so\" in this case refers to using port numbers.","commit_id":"37a0df2d4a27dfd21e50634d4e1e0a84d75ea302"},{"author":{"_account_id":11564,"name":"Chris Dent","email":"cdent@anticdent.org","username":"chdent"},"change_message_id":"d1fc976441a8240cbd9a8cdf6e4647dd6051e909","unresolved":false,"context_lines":[{"line_number":44,"context_line":"The rationale behind this recommendation is to ease use for users who may have"},{"line_number":45,"context_line":"restrictive port-blocking firewalls in their operating environment. Since the"},{"line_number":46,"context_line":"traffic is HTTP traffic and not a different protocol, it is not necessary to"},{"line_number":47,"context_line":"distinguish it by port number, and doing so increases the chances that users"},{"line_number":48,"context_line":"will have problems connecting to individual API endpoints."},{"line_number":49,"context_line":""},{"line_number":50,"context_line":".. _service-type-registration:"}],"source_content_type":"text/x-rst","patch_set":1,"id":"ff0f0b1f_b3275365","line":47,"in_reply_to":"3f044301_5112545a","updated":"2017-05-18 12:35:18.000000000","message":"port number. Doing so\n\ncould make it more clear (the \", and\" implies a list about the change not a commen on port number-ness)","commit_id":"37a0df2d4a27dfd21e50634d4e1e0a84d75ea302"},{"author":{"_account_id":8246,"name":"Qiming Teng","email":"tengqm@outlook.com","username":"tengqm"},"change_message_id":"d92e36a663de2d0750363ca0901d1d9a5ff8ae60","unresolved":false,"context_lines":[{"line_number":184,"context_line":"  An independent collection of services whose endpoints are registered into"},{"line_number":185,"context_line":"  the `Service Catalog`_ using the same name."},{"line_number":186,"context_line":""},{"line_number":187,"context_line":"A \"customer\" has an \"account\" on a \"cloud\". That \"cloud\" has one more more"},{"line_number":188,"context_line":"\"regions\", and each \"region\" has one more more API services."},{"line_number":189,"context_line":""},{"line_number":190,"context_line":"It is recommended that all clouds have a simple well-known name that can be"}],"source_content_type":"text/x-rst","patch_set":1,"id":"3f044301_f1e2802f","line":187,"range":{"start_line":187,"start_character":65,"end_line":187,"end_character":69},"updated":"2017-05-04 08:53:28.000000000","message":"or","commit_id":"37a0df2d4a27dfd21e50634d4e1e0a84d75ea302"},{"author":{"_account_id":11564,"name":"Chris Dent","email":"cdent@anticdent.org","username":"chdent"},"change_message_id":"d1fc976441a8240cbd9a8cdf6e4647dd6051e909","unresolved":false,"context_lines":[{"line_number":185,"context_line":"  the `Service Catalog`_ using the same name."},{"line_number":186,"context_line":""},{"line_number":187,"context_line":"A \"customer\" has an \"account\" on a \"cloud\". That \"cloud\" has one more more"},{"line_number":188,"context_line":"\"regions\", and each \"region\" has one more more API services."},{"line_number":189,"context_line":""},{"line_number":190,"context_line":"It is recommended that all clouds have a simple well-known name that can be"},{"line_number":191,"context_line":"used to uniquely identify the cloud for API consumers and in the"}],"source_content_type":"text/x-rst","patch_set":1,"id":"ff0f0b1f_539fd74f","line":188,"updated":"2017-05-18 12:35:18.000000000","message":"also s/more more/or more/ here","commit_id":"37a0df2d4a27dfd21e50634d4e1e0a84d75ea302"},{"author":{"_account_id":11564,"name":"Chris Dent","email":"cdent@anticdent.org","username":"chdent"},"change_message_id":"d1fc976441a8240cbd9a8cdf6e4647dd6051e909","unresolved":false,"context_lines":[{"line_number":232,"context_line":"* dallas01 # likely the first region located in Dallas, TX, USA"},{"line_number":233,"context_line":"* dfw # likely located in Dallas, TX, USA"},{"line_number":234,"context_line":"* us-east # likely located somewhere in the Eastern part of USA"},{"line_number":235,"context_line":"* antarctica01 # likely the first region located in antarctica"},{"line_number":236,"context_line":"* collider01 # likely located down in the first collider at CERN"},{"line_number":237,"context_line":"* advertising # likely located over in the advertising department"},{"line_number":238,"context_line":"* ftc-a3 # likley located in building a3 at our Fort Collins campus"}],"source_content_type":"text/x-rst","patch_set":1,"id":"ff0f0b1f_13f03f90","line":235,"updated":"2017-05-18 12:35:18.000000000","message":"/me signs up to work on this one","commit_id":"37a0df2d4a27dfd21e50634d4e1e0a84d75ea302"},{"author":{"_account_id":1063,"name":"Ed Leafe","email":"ed@leafe.com","username":"ed-leafe"},"change_message_id":"15fa8517115615353b7632d90354fc15f1213515","unresolved":false,"context_lines":[{"line_number":232,"context_line":"* dallas01 # likely the first region located in Dallas, TX, USA"},{"line_number":233,"context_line":"* dfw # likely located in Dallas, TX, USA"},{"line_number":234,"context_line":"* us-east # likely located somewhere in the Eastern part of USA"},{"line_number":235,"context_line":"* antarctica01 # likely the first region located in antarctica"},{"line_number":236,"context_line":"* collider01 # likely located down in the first collider at CERN"},{"line_number":237,"context_line":"* advertising # likely located over in the advertising department"},{"line_number":238,"context_line":"* ftc-a3 # likley located in building a3 at our Fort Collins campus"}],"source_content_type":"text/x-rst","patch_set":1,"id":"7f96bb07_d4c3fd36","line":235,"in_reply_to":"ff0f0b1f_13f03f90","updated":"2018-01-18 15:36:42.000000000","message":"/me buys cdent a one-way ticket","commit_id":"37a0df2d4a27dfd21e50634d4e1e0a84d75ea302"}],"guidelines/tags.rst":[{"author":{"_account_id":1063,"name":"Ed Leafe","email":"ed@leafe.com","username":"ed-leafe"},"change_message_id":"15fa8517115615353b7632d90354fc15f1213515","unresolved":false,"context_lines":[{"line_number":92,"context_line":"URL component can be added as a prefix instead of a suffix)."},{"line_number":93,"context_line":""},{"line_number":94,"context_line":"For example, the resource identified by URL"},{"line_number":95,"context_line":"*https://compute.example.com/servers/1234567890* must expose its tags with"},{"line_number":96,"context_line":"root URL *https://compute.example.com/servers/1234567890/tags*."},{"line_number":97,"context_line":""},{"line_number":98,"context_line":"Obtaining the Tag List"}],"source_content_type":"text/x-rst","patch_set":1,"id":"7f96bb07_b40bd18b","line":95,"range":{"start_line":95,"start_character":9,"end_line":95,"end_character":16},"updated":"2018-01-18 15:36:42.000000000","message":"Is it expected that there will be different hostnames for the different services?","commit_id":"37a0df2d4a27dfd21e50634d4e1e0a84d75ea302"}]}