On Thu, Aug 23, 2018 at 10:50:30AM +0200, Peter Krempa wrote: > The pathches used as an example for the api_extension manual don't hold s/pathches/patches > up to the current standards any more. Carefully remove links and > mentions of the patches from the docs. While I understand the impetus for the change, I am personally not convinced that we want to get rid of practical examples as a means of reference to the text, it's like a product documentation without examples - "hardcore mode". The fact that we took a patch series from the list archives as a reference probably wasn't the best thing to do, I think we should instead come up with a dummy API exercising all the sections in the docs which will conform to our current standards and which we can update as we please. I know that's much more work and effort which I can see you'd refuse to put into this, but I fear that once you drop this, we won't update the docs with another examples for years/ever and I'm not in favour of such practice. Erik -- libvir-list mailing list libvir-list@xxxxxxxxxx https://www.redhat.com/mailman/listinfo/libvir-list
