)]}'
{"doc/arch-design-draft/source/operator-requirements-network-design.rst":[{"author":{"_account_id":13995,"name":"Nate Johnston","email":"nate.johnston@redhat.com","username":"natejohnston"},"change_message_id":"20e4be6deee125beb207126da0cf910907b87b31","unresolved":false,"context_lines":[{"line_number":2,"context_line":"Network design"},{"line_number":3,"context_line":"\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d"},{"line_number":4,"context_line":""},{"line_number":5,"context_line":"The network design for an OpenStack cluster includes decisions regarding"},{"line_number":6,"context_line":"the interconnect needs within the cluster, plus the need to allow clients"},{"line_number":7,"context_line":"to access their resources, and for operators to access the cluster for"},{"line_number":8,"context_line":"maintenance. The bandwidth, latency, and reliability of these networks"},{"line_number":9,"context_line":"need to be considered."},{"line_number":10,"context_line":""},{"line_number":11,"context_line":"Whether you are using an external provider or an internal team, additional"}],"source_content_type":"text/x-rst","patch_set":1,"id":"bae84128_7ab940ec","line":8,"range":{"start_line":5,"start_character":53,"end_line":8,"end_character":12},"updated":"2016-02-25 15:31:38.000000000","message":"I think the parallelism of this could be improved by saying, \"decisions regarding the interconnect needs within the cluster, the need to allow clients to access their resources, and the access requirements for operators to administrate the cluster.\"  That makes it seem like a list of 3 equal things, as opposed to a list of 2 things, the second of which has two parts.","commit_id":"ee7cd717ae455dd22e0e3621928843ab9c7c475d"},{"author":{"_account_id":13995,"name":"Nate Johnston","email":"nate.johnston@redhat.com","username":"natejohnston"},"change_message_id":"20e4be6deee125beb207126da0cf910907b87b31","unresolved":false,"context_lines":[{"line_number":10,"context_line":""},{"line_number":11,"context_line":"Whether you are using an external provider or an internal team, additional"},{"line_number":12,"context_line":"design decisions about monitoring and alarming need to be made. If you are"},{"line_number":13,"context_line":"using an external provider, service level agreements (SLAs) likely apply"},{"line_number":14,"context_line":"with your contract. In addition, other operational considerations such as"},{"line_number":15,"context_line":"bandwidth, latency, and jitter can be part of the service level agreement."},{"line_number":16,"context_line":""},{"line_number":17,"context_line":"As demand for network resources increase, consider the ability to upgrade"}],"source_content_type":"text/x-rst","patch_set":1,"id":"bae84128_3af2189b","line":14,"range":{"start_line":13,"start_character":60,"end_line":14,"end_character":18},"updated":"2016-02-25 15:31:38.000000000","message":"\"apply with\" is awkward wording; I would replace with \"are typically defined in your contract\".","commit_id":"ee7cd717ae455dd22e0e3621928843ab9c7c475d"},{"author":{"_account_id":13995,"name":"Nate Johnston","email":"nate.johnston@redhat.com","username":"natejohnston"},"change_message_id":"20e4be6deee125beb207126da0cf910907b87b31","unresolved":false,"context_lines":[{"line_number":11,"context_line":"Whether you are using an external provider or an internal team, additional"},{"line_number":12,"context_line":"design decisions about monitoring and alarming need to be made. If you are"},{"line_number":13,"context_line":"using an external provider, service level agreements (SLAs) likely apply"},{"line_number":14,"context_line":"with your contract. In addition, other operational considerations such as"},{"line_number":15,"context_line":"bandwidth, latency, and jitter can be part of the service level agreement."},{"line_number":16,"context_line":""},{"line_number":17,"context_line":"As demand for network resources increase, consider the ability to upgrade"}],"source_content_type":"text/x-rst","patch_set":1,"id":"bae84128_dad7acbd","line":14,"range":{"start_line":14,"start_character":20,"end_line":14,"end_character":31},"updated":"2016-02-25 15:31:38.000000000","message":"You say \"In addition\" these extra things may be in your SLA, but the previous sentence just defines what an SLA is, it doesn\u0027t say what core features constitute an SLA that these extras would be in addition to.","commit_id":"ee7cd717ae455dd22e0e3621928843ab9c7c475d"},{"author":{"_account_id":13995,"name":"Nate Johnston","email":"nate.johnston@redhat.com","username":"natejohnston"},"change_message_id":"20e4be6deee125beb207126da0cf910907b87b31","unresolved":false,"context_lines":[{"line_number":14,"context_line":"with your contract. In addition, other operational considerations such as"},{"line_number":15,"context_line":"bandwidth, latency, and jitter can be part of the service level agreement."},{"line_number":16,"context_line":""},{"line_number":17,"context_line":"As demand for network resources increase, consider the ability to upgrade"},{"line_number":18,"context_line":"the infrastructure. Operators add additional IP address blocks and add"},{"line_number":19,"context_line":"additional bandwidth capacity. In addition, consider managing hardware and"},{"line_number":20,"context_line":"software lifecycle events, for example upgrades, decommissioning, and"},{"line_number":21,"context_line":"outages, while avoiding service interruptions for tenants."}],"source_content_type":"text/x-rst","patch_set":1,"id":"bae84128_b8e7513f","line":18,"range":{"start_line":17,"start_character":42,"end_line":18,"end_character":18},"updated":"2016-02-25 15:31:38.000000000","message":"Active voice conveys clearer meaning than passive: \"make sure your network design accommodates expansion and upgrade.\"","commit_id":"ee7cd717ae455dd22e0e3621928843ab9c7c475d"},{"author":{"_account_id":13995,"name":"Nate Johnston","email":"nate.johnston@redhat.com","username":"natejohnston"},"change_message_id":"182b171dc419fc403ead670527200b5c271affd0","unresolved":false,"context_lines":[{"line_number":11,"context_line":"Whether you are using an external provider or an internal team, additional"},{"line_number":12,"context_line":"design decisions about monitoring and alarming need to be made. If you are"},{"line_number":13,"context_line":"using an external provider, service level agreements (SLAs) are typically"},{"line_number":14,"context_line":"defined in your contract. In addition, other operational considerations"},{"line_number":15,"context_line":"such as bandwidth, latency, and jitter can be part of the service level"},{"line_number":16,"context_line":"agreement."},{"line_number":17,"context_line":""}],"source_content_type":"text/x-rst","patch_set":2,"id":"bae84128_079b78ca","line":14,"range":{"start_line":14,"start_character":26,"end_line":14,"end_character":71},"updated":"2016-02-25 16:39:53.000000000","message":"I think the \"In addition, other\" could be omitted; it doesn\u0027t add anything.","commit_id":"9e7273909c03d17429a11e8d8ee7604f9e4dc60c"},{"author":{"_account_id":10607,"name":"Alexandra Settle","email":"a.settle@outlook.com","username":"asettle"},"change_message_id":"0f93a46618741d8ba409c98c0d0ce7c7e9129016","unresolved":false,"context_lines":[{"line_number":6,"context_line":"the interconnect needs within the cluster, the need to allow clients to"},{"line_number":7,"context_line":"access their resources, and the access requirements for operators to"},{"line_number":8,"context_line":"administrate the cluster. The bandwidth, latency, and reliability of"},{"line_number":9,"context_line":"these networks need to be considered."},{"line_number":10,"context_line":""},{"line_number":11,"context_line":"Whether you are using an external provider or an internal team, additional"},{"line_number":12,"context_line":"design decisions about monitoring and alarming need to be made. If you are"}],"source_content_type":"text/x-rst","patch_set":3,"id":"9aed3d3a_ede80b7f","line":9,"range":{"start_line":9,"start_character":26,"end_line":9,"end_character":36},"updated":"2016-02-26 10:42:02.000000000","message":"Remove the passive voice, please","commit_id":"20447e1da9dff16c4f06ba610e3d33524aab21af"},{"author":{"_account_id":10607,"name":"Alexandra Settle","email":"a.settle@outlook.com","username":"asettle"},"change_message_id":"0f93a46618741d8ba409c98c0d0ce7c7e9129016","unresolved":false,"context_lines":[{"line_number":9,"context_line":"these networks need to be considered."},{"line_number":10,"context_line":""},{"line_number":11,"context_line":"Whether you are using an external provider or an internal team, additional"},{"line_number":12,"context_line":"design decisions about monitoring and alarming need to be made. If you are"},{"line_number":13,"context_line":"using an external provider, service level agreements (SLAs) are typically"},{"line_number":14,"context_line":"defined in your contract. Operational considerations such as bandwidth,"},{"line_number":15,"context_line":"latency, and jitter can be part of the service level agreement."}],"source_content_type":"text/x-rst","patch_set":3,"id":"9aed3d3a_cded478d","line":12,"range":{"start_line":12,"start_character":47,"end_line":12,"end_character":62},"updated":"2016-02-26 10:42:02.000000000","message":"ditto","commit_id":"20447e1da9dff16c4f06ba610e3d33524aab21af"},{"author":{"_account_id":10607,"name":"Alexandra Settle","email":"a.settle@outlook.com","username":"asettle"},"change_message_id":"0f93a46618741d8ba409c98c0d0ce7c7e9129016","unresolved":false,"context_lines":[{"line_number":12,"context_line":"design decisions about monitoring and alarming need to be made. If you are"},{"line_number":13,"context_line":"using an external provider, service level agreements (SLAs) are typically"},{"line_number":14,"context_line":"defined in your contract. Operational considerations such as bandwidth,"},{"line_number":15,"context_line":"latency, and jitter can be part of the service level agreement."},{"line_number":16,"context_line":""},{"line_number":17,"context_line":"As demand for network resources increase, make sure your network design"},{"line_number":18,"context_line":"accommodates expansion and upgrade. Operators add additional IP address"}],"source_content_type":"text/x-rst","patch_set":3,"id":"9aed3d3a_ad9563e5","line":15,"range":{"start_line":15,"start_character":39,"end_line":15,"end_character":62},"updated":"2016-02-26 10:42:02.000000000","message":"Just use SLA here","commit_id":"20447e1da9dff16c4f06ba610e3d33524aab21af"},{"author":{"_account_id":10607,"name":"Alexandra Settle","email":"a.settle@outlook.com","username":"asettle"},"change_message_id":"0f93a46618741d8ba409c98c0d0ce7c7e9129016","unresolved":false,"context_lines":[{"line_number":15,"context_line":"latency, and jitter can be part of the service level agreement."},{"line_number":16,"context_line":""},{"line_number":17,"context_line":"As demand for network resources increase, make sure your network design"},{"line_number":18,"context_line":"accommodates expansion and upgrade. Operators add additional IP address"},{"line_number":19,"context_line":"blocks and add additional bandwidth capacity. In addition, consider"},{"line_number":20,"context_line":"managing hardware and software lifecycle events, for example upgrades,"},{"line_number":21,"context_line":"decommissioning, and outages, while avoiding service interruptions for"}],"source_content_type":"text/x-rst","patch_set":3,"id":"9aed3d3a_cda42759","line":18,"range":{"start_line":18,"start_character":27,"end_line":18,"end_character":34},"updated":"2016-02-26 10:42:02.000000000","message":"upgrades*","commit_id":"20447e1da9dff16c4f06ba610e3d33524aab21af"}]}