On 28/03/17 21:24, debbie10t wrote: > > > On 28/03/17 19:18, debbie10t wrote: >> Hi, >> >> Following on from: >> https://www.mail-archive.com/openvpn-devel@lists.sourceforge.net/msg14330.html >> >> >> For your consideration: >> https://community.openvpn.net/openvpn/wiki/DeprecationWarnings >> >> I do understand why duplicating work is not preferred, which is >> why the page is for priority Warnings .. it could also be that >> --ns-cert-type is going to be the only deprecation which qualifies >> for such a warning, so the page could be recreated for --ns-cert-type >> specifically. >> >> The page could also serve as a perma-link for log warnings. > > Here is a further example of what I am thinking: > https://community.openvpn.net/openvpn/wiki/DeprecationWarnings#warnnsct
Thanks, debbie10t! This is a very good starting point. I am just wondering if we should have some kind of "standard table" within each of these warning blocks which contains a consistent overview of "what and when". I don't have a good suggesting right now but something like: | Feature | Deprecated | Removed | +-------------------------+---------------+-----------+ | option: --ns-cert-type | v2.4.1 | TBD | +-------------------------+---------------+-----------+ And then below such a table, the rationale for removing it, pointers to more information and other types of important notes related to this. The "Deprecated" and "Removed" columns could also point at the git commit containing the deprecation/removal. Of course, this wiki-page will require some maintenance ... and I hope this maintenance load will not just be dumped only to us core developers. -- kind regards, David Sommerseth OpenVPN Technologies, Inc
signature.asc
Description: OpenPGP digital signature
------------------------------------------------------------------------------ Check out the vibrant tech community on one of the world's most engaging tech sites, Slashdot.org! http://sdm.link/slashdot
_______________________________________________ Openvpn-devel mailing list Openvpn-devel@lists.sourceforge.net https://lists.sourceforge.net/lists/listinfo/openvpn-devel