)]}'
{"doc/source/users/index.rst":[{"author":{"_account_id":1112,"name":"Everett Toews","email":"everett.toews@rackspace.com","username":"everett-toews"},"change_message_id":"0bfb618dc9eea675c1c59b7adc17599902866130","unresolved":false,"context_lines":[{"line_number":39,"context_line":"********************"},{"line_number":40,"context_line":""},{"line_number":41,"context_line":"A *Connection* instance maintains your session, authentication, transport,"},{"line_number":42,"context_line":"and preferences, providing you with a set of higher-level interfaces to work"},{"line_number":43,"context_line":"with OpenStack services."},{"line_number":44,"context_line":""},{"line_number":45,"context_line":".. toctree::"}],"source_content_type":"text/x-rst","patch_set":3,"id":"da86d52c_8cf07568","line":42,"updated":"2015-02-04 23:22:37.000000000","message":"As a new user I didn\u0027t fully understand the implications of \"higher-level interfaces\" here vs \"lower-level interface\" below.\n\nI think you need to add a sentence at the end of this paragraph flat out saying that the Connection Interface is the recommended way to work with services.","commit_id":"563da94056b9dec23351f6e99142df09c656dd56"},{"author":{"_account_id":1112,"name":"Everett Toews","email":"everett.toews@rackspace.com","username":"everett-toews"},"change_message_id":"55059f99476e744561c7bfbdbc453a1be46d6cf4","unresolved":false,"context_lines":[{"line_number":62,"context_line":""},{"line_number":63,"context_line":"The *Resource* layer is a lower-level interface to communicate with OpenStack"},{"line_number":64,"context_line":"services. While the classes exposed by the *Connection* build a convenience"},{"line_number":65,"context_line":"layer on top of this, *Resources* can be used directly. However, the most"},{"line_number":66,"context_line":"common usage of this layer is in receiving an object from a class in the"},{"line_number":67,"context_line":"*Connection* layer, modifying it, and sending it back into the *Connection*"},{"line_number":68,"context_line":"layer, such as to update a resource on the server."}],"source_content_type":"text/x-rst","patch_set":3,"id":"da86d52c_6f7b418c","line":65,"updated":"2015-02-04 17:39:15.000000000","message":"Is the convenience layer referenced here the Proxy layer?\n\nShould there be a Proxy Interface section above this section in this doc?","commit_id":"563da94056b9dec23351f6e99142df09c656dd56"},{"author":{"_account_id":8257,"name":"Brian Curtin","email":"brian@python.org","username":"briancurtin"},"change_message_id":"7458668608a0f72608336f5d97220366570922b4","unresolved":false,"context_lines":[{"line_number":62,"context_line":""},{"line_number":63,"context_line":"The *Resource* layer is a lower-level interface to communicate with OpenStack"},{"line_number":64,"context_line":"services. While the classes exposed by the *Connection* build a convenience"},{"line_number":65,"context_line":"layer on top of this, *Resources* can be used directly. However, the most"},{"line_number":66,"context_line":"common usage of this layer is in receiving an object from a class in the"},{"line_number":67,"context_line":"*Connection* layer, modifying it, and sending it back into the *Connection*"},{"line_number":68,"context_line":"layer, such as to update a resource on the server."}],"source_content_type":"text/x-rst","patch_set":3,"id":"da86d52c_77479777","line":65,"in_reply_to":"da86d52c_6f7b418c","updated":"2015-02-04 19:46:12.000000000","message":"The Proxy section is above this. Connection objects discover and expose you to the Proxy classes, but they\u0027re not intended to be used directly. That\u0027s part of the reason they\u0027re in a private module - each Proxy class comes from the _proxy.py in a particular version of a service. You could go on and import _proxy modules on your own, but...you\u0027re on your own.\n\nWhile we\u0027ll talk more about them in the contributor section, I would prefer to have users think of things in the manner they\u0027ll use them, which is through either the Resource or the Connection.\n\nPerhaps \"interface\" isn\u0027t the right title for those names, but I want to get away from our previous generic terms low level and high level.","commit_id":"563da94056b9dec23351f6e99142df09c656dd56"}]}