<div dir="ltr"><div class="gmail_extra"><div class="gmail_quote"><div>Markus,</div><div><br></div><div> </div><blockquote class="gmail_quote" style="margin:0px 0px 0px 0.8ex;border-left-width:1px;border-left-color:rgb(204,204,204);border-left-style:solid;padding-left:1ex"><span class="">
> Yes, in what release it is to be removed, e.g. Mitaka.  So when is<br>
> that release cycle, i.e. now once removed there is no record.<br>
<br>
</span>The information at which point in time a removal will happen can be<br>
derived from a combination of:<br>
* the "Deprecation Notes" (e.g. Nova's at [1]) and<br>
* the "follows_standard_deprecation" policy [2].<br>
I don't see the immediate need to duplicate that information.<br><br></blockquote><div><br></div><div>The potential duplication you refer to enables code scanning/automation to detect and even initiate steps at the start of a release cycle to remove deprecated options.</div><div>Looking at documented notes is a more inconsistent manual approach. The number of deprecated options should not be high, I do not see the issue in ensuring this information is in code as well as docs.</div><div><br></div><div> <br></div><blockquote class="gmail_quote" style="margin:0px 0px 0px 0.8ex;border-left-width:1px;border-left-color:rgb(204,204,204);border-left-style:solid;padding-left:1ex">
I agree that there should be an explanation in ``deprecation_reason``<br>
if ``deprecated_for_removal=True`` **why** we deprecated it and which<br>
follow up actions seem to be reasonable for the ops.<br>
<br>
</blockquote><div><br></div><div>Thanks!  I think for now, stating a reason, stating what release it was deprecated and what release it should be removed provides a starting point with a low barrier of entry to see results.</div><div><br></div><div>Ronald (rbradfor)</div><div><br></div><div> </div><blockquote class="gmail_quote" style="margin:0px 0px 0px 0.8ex;border-left-width:1px;border-left-color:rgb(204,204,204);border-left-style:solid;padding-left:1ex">References:<br>
[1] Nova's current release notes based on "reno"; "Deprecation Notes":<br>
<br>
<a href="http://docs.openstack.org/releasenotes/nova/unreleased.html#deprecation-notes" rel="noreferrer" target="_blank">http://docs.openstack.org/releasenotes/nova/unreleased.html#deprecation-notes</a><br>
[2] OpenStack governance docs; tag "assert_follows_standard_deprecation":<br>
<br>
<a href="https://governance.openstack.org/reference/tags/assert_follows-standard-deprecation.html" rel="noreferrer" target="_blank">https://governance.openstack.org/reference/tags/assert_follows-standard-deprecation.html</a><br>
<br>
Regards, Markus Zoeller (markus_z)<br><div class=""><div class="h5"><br>
</div></div></blockquote></div><br></div></div>