)]}'
{"shade/openstackcloud.py":[{"author":{"_account_id":3099,"name":"David Shrewsbury","email":"dshrewsb@redhat.com","username":"dshrews"},"change_message_id":"2aad32bb7026ea600a7602c47aa5431ac063c14c","unresolved":false,"context_lines":[{"line_number":3534,"context_line":"        List all volume backups."},{"line_number":3535,"context_line":""},{"line_number":3536,"context_line":"        :param detailed: Also list details for each entry"},{"line_number":3537,"context_line":"        :type detailed: bool"},{"line_number":3538,"context_line":"        :param search_opts: Search options"},{"line_number":3539,"context_line":"        :type search_opts: dict"},{"line_number":3540,"context_line":"        :returns: A list of volume backups ``munch.Munch``."}],"source_content_type":"text/x-python","patch_set":3,"id":"fa6399be_7e19bbd6","line":3537,"updated":"2016-10-13 14:52:28.000000000","message":"For consistency with the rest of the codebase, please put the type after \u0027param\u0027. E.g,\n\n   :param bool detailed:","commit_id":"260c04f11f0bdcf8522dafd834fa0b20d77affa7"},{"author":{"_account_id":3099,"name":"David Shrewsbury","email":"dshrewsb@redhat.com","username":"dshrews"},"change_message_id":"2aad32bb7026ea600a7602c47aa5431ac063c14c","unresolved":false,"context_lines":[{"line_number":3536,"context_line":"        :param detailed: Also list details for each entry"},{"line_number":3537,"context_line":"        :type detailed: bool"},{"line_number":3538,"context_line":"        :param search_opts: Search options"},{"line_number":3539,"context_line":"        :type search_opts: dict"},{"line_number":3540,"context_line":"        :returns: A list of volume backups ``munch.Munch``."},{"line_number":3541,"context_line":"        \"\"\""},{"line_number":3542,"context_line":"        with _utils.shade_exceptions(\"Error getting a list of backups\"):"}],"source_content_type":"text/x-python","patch_set":3,"id":"fa6399be_de2807e5","line":3539,"updated":"2016-10-13 14:52:28.000000000","message":"Same comment as above.\n\nIt would also be good if we could expand on the search_opts description a bit. OpenStack API docs are terrible like this. What can I search? Add an example if that helps (see get_keypair() for formatting of an example dict).","commit_id":"260c04f11f0bdcf8522dafd834fa0b20d77affa7"},{"author":{"_account_id":7350,"name":"Jordan Pittier","email":"jordan.pittier@gmail.com","username":"JordanP"},"change_message_id":"be60e25c7dbea472887a93372568f2afe59b09b4","unresolved":false,"context_lines":[{"line_number":3536,"context_line":"        :param detailed: Also list details for each entry"},{"line_number":3537,"context_line":"        :type detailed: bool"},{"line_number":3538,"context_line":"        :param search_opts: Search options"},{"line_number":3539,"context_line":"        :type search_opts: dict"},{"line_number":3540,"context_line":"        :returns: A list of volume backups ``munch.Munch``."},{"line_number":3541,"context_line":"        \"\"\""},{"line_number":3542,"context_line":"        with _utils.shade_exceptions(\"Error getting a list of backups\"):"}],"source_content_type":"text/x-python","patch_set":3,"id":"fa6399be_fb668beb","line":3539,"in_reply_to":"fa6399be_d8fb8d77","updated":"2016-10-14 13:47:35.000000000","message":"Bah sorry, for this strong reaction. All I am trying to say is this adds to the already lengthy file :)","commit_id":"260c04f11f0bdcf8522dafd834fa0b20d77affa7"},{"author":{"_account_id":7350,"name":"Jordan Pittier","email":"jordan.pittier@gmail.com","username":"JordanP"},"change_message_id":"55ea2022ff19017dc33574a9ba02af05f2fe7196","unresolved":false,"context_lines":[{"line_number":3536,"context_line":"        :param detailed: Also list details for each entry"},{"line_number":3537,"context_line":"        :type detailed: bool"},{"line_number":3538,"context_line":"        :param search_opts: Search options"},{"line_number":3539,"context_line":"        :type search_opts: dict"},{"line_number":3540,"context_line":"        :returns: A list of volume backups ``munch.Munch``."},{"line_number":3541,"context_line":"        \"\"\""},{"line_number":3542,"context_line":"        with _utils.shade_exceptions(\"Error getting a list of backups\"):"}],"source_content_type":"text/x-python","patch_set":3,"id":"fa6399be_d8fb8d77","line":3539,"in_reply_to":"fa6399be_de2807e5","updated":"2016-10-14 13:34:51.000000000","message":"I am going to do what you want. But I don\u0027t agree. Shade source code is not the place to document Cinder API. And I doubt we/you are going to do a better job at documenting it than docs.openstack.org.\n\nSeriously, Shade is great as a user. But that 6k+ LoC file is a PITA to contribute to.","commit_id":"260c04f11f0bdcf8522dafd834fa0b20d77affa7"},{"author":{"_account_id":3099,"name":"David Shrewsbury","email":"dshrewsb@redhat.com","username":"dshrews"},"change_message_id":"9cf17027449464325919e97738818661836de859","unresolved":false,"context_lines":[{"line_number":3536,"context_line":"        :param detailed: Also list details for each entry"},{"line_number":3537,"context_line":"        :type detailed: bool"},{"line_number":3538,"context_line":"        :param search_opts: Search options"},{"line_number":3539,"context_line":"        :type search_opts: dict"},{"line_number":3540,"context_line":"        :returns: A list of volume backups ``munch.Munch``."},{"line_number":3541,"context_line":"        \"\"\""},{"line_number":3542,"context_line":"        with _utils.shade_exceptions(\"Error getting a list of backups\"):"}],"source_content_type":"text/x-python","patch_set":3,"id":"fa6399be_9b0e6fe3","line":3539,"in_reply_to":"fa6399be_fb668beb","updated":"2016-10-14 13:53:30.000000000","message":"I don\u0027t want to document the cinder API, I want to document shade\u0027s.\n\nNot looking for an all-encompassing description here. Just something that expresses to someone who doesn\u0027t know the Cinder API (and who is coming to shade b/c it\u0027s supposed to be easier to use) how to use this param. Even something like \"A dictionary of values used for matching against the volume structure\" (Is that even what it is? I don\u0027t know, which is why I ask for some more detail.)","commit_id":"260c04f11f0bdcf8522dafd834fa0b20d77affa7"}]}