<div dir="ltr">On 18 June 2016 at 17:23, salsaman <span dir="ltr"><<a href="mailto:salsaman@gmail.com" target="_blank">salsaman@gmail.com</a>></span> wrote:<br><div class="gmail_extra"><div class="gmail_quote"><blockquote class="gmail_quote" style="margin:0 0 0 .8ex;border-left:1px #ccc solid;padding-left:1ex"><div dir="ltr"><div><div><div>Creating a migration guide is standard practice when changing the major version of a well used library API. <br>Is there really no documentation anywhere ? That seems to defeat the purpose of providing a usable library.<br><br></div>Code examples only provide solutions for specific implementation details.<br><br><br></div>Regards,<br></div>Salsaman.<br></div></blockquote><div><br></div><div>I second that. FreeBSD is still going through the motions of trying to update numerous open source software packages to use the newest API. And there are plenty which have not yet done it themselves, and therefore require manual patching. We use patches from Linux distributions when they are available, but some are not and we work it out from examples.<br><br></div><div>I believe that a good API documentation should not just explain what is available in each version, but what has changed since the last version and the recommended alternative.<br><br></div><div>Regards,<br></div><div>Ben <br></div></div></div></div>