Re: [Xen-devel] Migrating key developer docs to xen.git sphinx docs and refreshing them in the process

2019-06-25 Thread Julien Grall
Hi Stefano, On 6/25/19 10:18 PM, Stefano Stabellini wrote: On Tue, 25 Jun 2019, Julien Grall wrote: The point here is that we can be flexible and creative about the way to maintain the docs on xen.git. But as a technology is certainly better than the wiki: we don't have to keep them all

Re: [Xen-devel] Migrating key developer docs to xen.git sphinx docs and refreshing them in the process

2019-06-25 Thread Stefano Stabellini
On Tue, 25 Jun 2019, Julien Grall wrote: > > > > The point here is that we can be flexible and creative about the way to > > > > maintain the docs on xen.git. But as a technology is certainly better > > > > than the wiki: we don't have to keep them all up-to-date with the code, > > > > but at

Re: [Xen-devel] Migrating key developer docs to xen.git sphinx docs and refreshing them in the process

2019-06-25 Thread Rich Persaud
> On Jun 25, 2019, at 12:34, Lars Kurth wrote: > > On 25/06/2019, 14:47, "Andrew Cooper" wrote: > >> On 25/06/2019 13:15, Lars Kurth wrote: >> On 25/06/2019, 10:03, "Julien Grall" wrote: >> > The point here is that we can be flexible and creative about the way to > maintain the

Re: [Xen-devel] Migrating key developer docs to xen.git sphinx docs and refreshing them in the process

2019-06-25 Thread P S
> On Jun 25, 2019, at 12:34, Lars Kurth wrote: > > > > On 25/06/2019, 14:47, "Andrew Cooper" wrote: > >>On 25/06/2019 13:15, Lars Kurth wrote: >> On 25/06/2019, 10:03, "Julien Grall" wrote: >> > The point here is that we can be flexible and creative about the way to >

Re: [Xen-devel] Migrating key developer docs to xen.git sphinx docs and refreshing them in the process

2019-06-25 Thread Andrew Cooper
On 25/06/2019 17:34, Lars Kurth wrote: > > On 25/06/2019, 14:47, "Andrew Cooper" wrote: > > On 25/06/2019 13:15, Lars Kurth wrote: > > On 25/06/2019, 10:03, "Julien Grall" wrote: > > > > >>> The point here is that we can be flexible and creative about > the way to > >

Re: [Xen-devel] Migrating key developer docs to xen.git sphinx docs and refreshing them in the process

2019-06-25 Thread Lars Kurth
On 25/06/2019, 14:47, "Andrew Cooper" wrote: On 25/06/2019 13:15, Lars Kurth wrote: > On 25/06/2019, 10:03, "Julien Grall" wrote: > > >>> The point here is that we can be flexible and creative about the way to > >>> maintain the docs on xen.git. But as a

Re: [Xen-devel] Migrating key developer docs to xen.git sphinx docs and refreshing them in the process

2019-06-25 Thread Andrew Cooper
On 25/06/2019 13:15, Lars Kurth wrote: > On 25/06/2019, 10:03, "Julien Grall" wrote: > > >>> The point here is that we can be flexible and creative about the way > to > >>> maintain the docs on xen.git. But as a technology is certainly better > >>> than the wiki: we don't have to

Re: [Xen-devel] Migrating key developer docs to xen.git sphinx docs and refreshing them in the process

2019-06-25 Thread Lars Kurth
On 25/06/2019, 10:03, "Julien Grall" wrote: >>> The point here is that we can be flexible and creative about the way to >>> maintain the docs on xen.git. But as a technology is certainly better >>> than the wiki: we don't have to keep them all up-to-date with the code, >>> but

Re: [Xen-devel] Migrating key developer docs to xen.git sphinx docs and refreshing them in the process

2019-06-25 Thread Julien Grall
Hi Stefano, On 25/06/2019 01:02, Stefano Stabellini wrote: On Mon, 24 Jun 2019, Julien Grall wrote: Hi Stefano, On 6/24/19 9:23 PM, Stefano Stabellini wrote: On Mon, 24 Jun 2019, Julien Grall wrote: Hi, On 24/06/2019 19:03, Stefano Stabellini wrote: On Mon, 24 Jun 2019, Lars Kurth wrote:

Re: [Xen-devel] Migrating key developer docs to xen.git sphinx docs and refreshing them in the process

2019-06-24 Thread Stefano Stabellini
On Mon, 24 Jun 2019, Julien Grall wrote: > Hi Stefano, > > On 6/24/19 9:23 PM, Stefano Stabellini wrote: > > On Mon, 24 Jun 2019, Julien Grall wrote: > > > Hi, > > > > > > On 24/06/2019 19:03, Stefano Stabellini wrote: > > > > On Mon, 24 Jun 2019, Lars Kurth wrote: > > > > I think we all agree

Re: [Xen-devel] Migrating key developer docs to xen.git sphinx docs and refreshing them in the process

2019-06-24 Thread Julien Grall
Hi Stefano, On 6/24/19 9:23 PM, Stefano Stabellini wrote: On Mon, 24 Jun 2019, Julien Grall wrote: Hi, On 24/06/2019 19:03, Stefano Stabellini wrote: On Mon, 24 Jun 2019, Lars Kurth wrote: I think we all agree by now that maintaining up-to-date docs on the wiki and keeping them in sync with

Re: [Xen-devel] Migrating key developer docs to xen.git sphinx docs and refreshing them in the process

2019-06-24 Thread Stefano Stabellini
On Mon, 24 Jun 2019, Julien Grall wrote: > Hi, > > On 24/06/2019 19:03, Stefano Stabellini wrote: > > On Mon, 24 Jun 2019, Lars Kurth wrote: > > I think we all agree by now that maintaining up-to-date docs on the wiki > > and keeping them in sync with code changes is hard. I see moving things > >

Re: [Xen-devel] Migrating key developer docs to xen.git sphinx docs and refreshing them in the process

2019-06-24 Thread Stefano Stabellini
On Mon, 24 Jun 2019, Lars Kurth wrote: > Hi all, > > since Andy created https://xenbits.xen.org/docs/sphinx-unstable/ and > https://xenbits.xen.org/docs/sphinx-unstable-staging/ (sources in > docs/hypervisor-guide, docs/guest-guide, docs/admin-guide) I was wondering > whether it would not make

[Xen-devel] Migrating key developer docs to xen.git sphinx docs and refreshing them in the process

2019-06-24 Thread Lars Kurth
Hi all, since Andy created https://xenbits.xen.org/docs/sphinx-unstable/ and https://xenbits.xen.org/docs/sphinx-unstable-staging/ (sources in docs/hypervisor-guide, docs/guest-guide, docs/admin-guide) I was wondering whether it would not make sense to migrate some key documents in the wiki