<div dir="ltr"><div class="gmail_extra"><div class="gmail_quote">On Tue, May 17, 2016 at 12:25 PM, Andrew Laski <span dir="ltr"><<a href="mailto:andrew@lascii.com" target="_blank">andrew@lascii.com</a>></span> wrote:<br><blockquote class="gmail_quote" style="margin:0px 0px 0px 0.8ex;border-left-width:1px;border-left-style:solid;border-left-color:rgb(204,204,204);padding-left:1ex">I was in a discussion earlier about discouraging deployers from using<br>
deprecated options and the question came up about why we put deprecated<br>
options into the sample files generated in the various projects. So, why<br>
do we do that?<br>
<br>
I view the sample file as a reference to be used when setting up a<br>
service for the first time, or when looking to configure something for<br>
the first time. In neither of those cases do I see a benefit to<br>
advertising options that are marked deprecated.<br>
<br>
Is there some other case I'm not considering here? And how does everyone<br>
feel about modifying the sample file generation to exclude options which<br>
are marked with "deprecated_for_removal"?<br>
<br><br></blockquote><div><br></div><div><br></div><div>Can you clarify what you mean by having them? The way they are now is great for deployers I think and people (like me) who work on things like puppet and need to update options sometimes. For example, I like this way, example from keystone:</div><div><br></div><div><div># Deprecated group/name - [DEFAULT]/log_config</div><div>#log_config_append = <None></div></div><div><br></div><div>Are you proposing removing that top line?</div></div><br></div></div>