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@redhat.com
https://www.redhat.com/mailman/listinfo/libvir-list

Reply via email to