On Wed, Mar 23, 2016 at 11:57 AM, Kashyap Chamarthy <kchamart(a)redhat.com>
wrote:
On Wed, Mar 23, 2016 at 09:46:56AM +0000, Daniel P. Berrange wrote:
> On Wed, Mar 23, 2016 at 05:47:31AM +0100, Kashyap Chamarthy wrote:
[...]
> > A related topic: At a future point in time, the libvirt Wiki could
> > probably be migrated to Git-based static-site generator project
> > Middleman? Most recently, two projects that I know of have made the
> > switch (RDO Project & oVirt).
>
> That seems to completely defeat the point of having a wiki. We already
> have a static website maintained in GIT and get essentially zero end
> user contributions to it. A wiki is intended to be quick & easy for
> people to just directly create content without having to learn any
> tools or process beyond their web browser
Fair enough. Taking myself as an example, I have written/edited a few
libvirt wiki pages than touching in the in-tree docs. I anticipated
you'd say this (about having an easy way to quickly write a doc).
Apparently Github pull requests and editing in Markdown are the new thing,
and people somehow find it usable.
It also brings them somehow closer to development, having to enjoy the
finesse of working with Git, etc...
The main advantage is that their is review to the content being edited
proactively.
Y.
--
/kashyap
--
libvir-list mailing list
libvir-list(a)redhat.com
https://www.redhat.com/mailman/listinfo/libvir-list