)]}'
{"specs/policy/deprecation-management.rst":[{"author":{"_account_id":1297,"name":"Joshua Harlow","email":"jxharlow@godaddy.com","username":"harlowja"},"change_message_id":"190cf46677a32b201e8f4d563a42aa48db02ad7a","unresolved":false,"context_lines":[{"line_number":12,"context_line":"Oslo libraries have varied means of reporting and managing"},{"line_number":13,"context_line":"deprecation of attributes, functions, classes and configuration."},{"line_number":14,"context_line":"These varied means include attributes for configuration options,"},{"line_number":15,"context_line":"the debtcollector package and oslo.log versionutils. "},{"line_number":16,"context_line":""},{"line_number":17,"context_line":"There is no clear policy that encompasses the best practices, API"},{"line_number":18,"context_line":"backward compatibility needs and deprecation period for the various"}],"source_content_type":"text/x-rst","patch_set":2,"id":"1a122d0e_7f25645a","line":15,"updated":"2016-05-04 18:59:47.000000000","message":"Spaceeee!","commit_id":"617018e1e8b75e194b6a208231efd5b67e763b4e"},{"author":{"_account_id":1297,"name":"Joshua Harlow","email":"jxharlow@godaddy.com","username":"harlowja"},"change_message_id":"99c62fcacf8696378b7ec1897167b7092ef639a9","unresolved":false,"context_lines":[{"line_number":217,"context_line":"This policy would propose that the **deprecated_reason** be used to"},{"line_number":218,"context_line":"record this information."},{"line_number":219,"context_line":""},{"line_number":220,"context_line":"versionutils"},{"line_number":221,"context_line":"------------"},{"line_number":222,"context_line":""},{"line_number":223,"context_line":"For the deprecation of a class or function the following versionutils"}],"source_content_type":"text/x-rst","patch_set":2,"id":"da0c15f0_56bb73c4","line":220,"updated":"2016-03-25 22:20:20.000000000","message":"I\u0027d almost rather remove this and put something dinky in debtcollector to do something simililar... Because IMHO all this whole code has is a list of openstack releases in it and enums for those releases and a ability to have +1 or +X","commit_id":"617018e1e8b75e194b6a208231efd5b67e763b4e"},{"author":{"_account_id":1297,"name":"Joshua Harlow","email":"jxharlow@godaddy.com","username":"harlowja"},"change_message_id":"190cf46677a32b201e8f4d563a42aa48db02ad7a","unresolved":false,"context_lines":[{"line_number":246,"context_line":"In this usage, the specific OpenStack version is specified and"},{"line_number":247,"context_line":"included in messages. The use of versionutils is for deployer-facing"},{"line_number":248,"context_line":"messaging, where the subsequent debtcollector is for developer"},{"line_number":249,"context_line":"deprecations."},{"line_number":250,"context_line":""},{"line_number":251,"context_line":"The use of this decorator does not require the **remove_in** attribute"},{"line_number":252,"context_line":"to be specified.  This policy would propose that this is required."}],"source_content_type":"text/x-rst","patch_set":2,"id":"1a122d0e_5fad089a","line":249,"updated":"2016-05-04 18:59:47.000000000","message":"Another option is that we just use debtcollector here for both, but in the case of deployer-facing deprecations we recommend using the \u0027redirect_into\u0027 of https://review.openstack.org/#/c/312687/ (and redirect into a logger, maybe provide in versionutils that logger function).","commit_id":"617018e1e8b75e194b6a208231efd5b67e763b4e"},{"author":{"_account_id":1297,"name":"Joshua Harlow","email":"jxharlow@godaddy.com","username":"harlowja"},"change_message_id":"190cf46677a32b201e8f4d563a42aa48db02ad7a","unresolved":false,"context_lines":[{"line_number":247,"context_line":"included in messages. The use of versionutils is for deployer-facing"},{"line_number":248,"context_line":"messaging, where the subsequent debtcollector is for developer"},{"line_number":249,"context_line":"deprecations."},{"line_number":250,"context_line":""},{"line_number":251,"context_line":"The use of this decorator does not require the **remove_in** attribute"},{"line_number":252,"context_line":"to be specified.  This policy would propose that this is required."},{"line_number":253,"context_line":"It is presently possible to specify a **remove_in\u003dNone** indicating the"}],"source_content_type":"text/x-rst","patch_set":2,"id":"1a122d0e_df71180e","line":250,"updated":"2016-05-04 18:59:47.000000000","message":"A second option is to just start to enable https://docs.python.org/2/library/logging.html#integration-with-the-warnings-module by default, then use debtcollector to replace versionutils (or remove most of versionutils at that point and leave a tiny layer in versionutils that handles the release + N stuff).","commit_id":"617018e1e8b75e194b6a208231efd5b67e763b4e"},{"author":{"_account_id":1297,"name":"Joshua Harlow","email":"jxharlow@godaddy.com","username":"harlowja"},"change_message_id":"99c62fcacf8696378b7ec1897167b7092ef639a9","unresolved":false,"context_lines":[{"line_number":277,"context_line":""},{"line_number":278,"context_line":"The debcollector package is not OpenStack specific. The version"},{"line_number":279,"context_line":"information specified when deprecating is a X.Y.Z version number. "},{"line_number":280,"context_line":""},{"line_number":281,"context_line":""},{"line_number":282,"context_line":""},{"line_number":283,"context_line":"Alternatives \u0026 History"}],"source_content_type":"text/x-rst","patch_set":2,"id":"da0c15f0_56e253d6","line":280,"updated":"2016-03-25 22:20:20.000000000","message":"Agreed, seems like we could make versionutils from above just use debtcollector with a small/tiny shim (the shim would have the openstack releases and the +X release information/algorithm).","commit_id":"617018e1e8b75e194b6a208231efd5b67e763b4e"},{"author":{"_account_id":1297,"name":"Joshua Harlow","email":"jxharlow@godaddy.com","username":"harlowja"},"change_message_id":"99c62fcacf8696378b7ec1897167b7092ef639a9","unresolved":false,"context_lines":[{"line_number":287,"context_line":"capacity within Oslo libraries and other projects. However, the use"},{"line_number":288,"context_line":"is inconsistent or not provide adequate history or details when the"},{"line_number":289,"context_line":"functionality exists to report these details."},{"line_number":290,"context_line":""},{"line_number":291,"context_line":""},{"line_number":292,"context_line":"Implementation"},{"line_number":293,"context_line":"\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d"}],"source_content_type":"text/x-rst","patch_set":2,"id":"da0c15f0_16d9fb21","line":290,"updated":"2016-03-25 22:20:20.000000000","message":"Let me know how much of this history u want to know about ;)\n\nAnd/or I can fill in part of this, ha.","commit_id":"617018e1e8b75e194b6a208231efd5b67e763b4e"}]}
