Re: [Xen-devel] [RFC] Documentation formats, licenses and file system structure

2019-11-08 Thread Stefano Stabellini
On Thu, 7 Nov 2019, Lars Kurth wrote: > Hi all, > > I have received informal advice > > On 21/10/2019, 06:54, "Artem Mygaiev" wrote: > > > Before we ask Xen FuSA contributors to invest in documentation to > > be presented as legally-valid evidence for certification, we should > >

Re: [Xen-devel] [RFC] Documentation formats, licenses and file system structure

2019-11-07 Thread Lars Kurth
Hi all, I have received informal advice On 21/10/2019, 06:54, "Artem Mygaiev" wrote: > Before we ask Xen FuSA contributors to invest in documentation to > be presented as legally-valid evidence for certification, we should > ask a certified lawyer for their formal opinion on the

Re: [Xen-devel] [RFC] Documentation formats, licenses and file system structure

2019-10-21 Thread Artem Mygaiev
Hi Lars On Thu, 2019-10-17 at 17:30 +, Lars Kurth wrote: > > On 17/10/2019, 18:05, "Rich Persaud" < > pers...@gmail.com > > wrote: > > On Oct 17, 2019, at 12:55, Stefano Stabellini < > sstabell...@kernel.org > > wrote: > > > > On Thu, 17 Oct 2019, Rich Persaud wrote: > >>>

Re: [Xen-devel] [RFC] Documentation formats, licenses and file system structure

2019-10-17 Thread Lars Kurth
On 17/10/2019, 18:05, "Rich Persaud" wrote: On Oct 17, 2019, at 12:55, Stefano Stabellini wrote: > > On Thu, 17 Oct 2019, Rich Persaud wrote: >>> On Oct 17, 2019, at 12:32, Stefano Stabellini wrote: >>> >>> On Thu, 17 Oct 2019, Lars Kurth wrote: On

Re: [Xen-devel] [RFC] Documentation formats, licenses and file system structure

2019-10-17 Thread Rich Persaud
On Oct 17, 2019, at 12:55, Stefano Stabellini wrote: > > On Thu, 17 Oct 2019, Rich Persaud wrote: >>> On Oct 17, 2019, at 12:32, Stefano Stabellini >>> wrote: >>> >>> On Thu, 17 Oct 2019, Lars Kurth wrote: On 16/10/2019, 17:35, "Rich Persaud" wrote: >> On Oct 15, 2019, at

Re: [Xen-devel] [RFC] Documentation formats, licenses and file system structure

2019-10-17 Thread Stefano Stabellini
On Thu, 17 Oct 2019, Rich Persaud wrote: > On Oct 17, 2019, at 12:32, Stefano Stabellini wrote: > > > > On Thu, 17 Oct 2019, Lars Kurth wrote: > >> On 16/10/2019, 17:35, "Rich Persaud" wrote: > >> > On Oct 15, 2019, at 08:27, Lars Kurth wrote: > >>> ... > >>> > >>> My point really was

Re: [Xen-devel] [RFC] Documentation formats, licenses and file system structure

2019-10-17 Thread Rich Persaud
On Oct 17, 2019, at 12:32, Stefano Stabellini wrote: > > On Thu, 17 Oct 2019, Lars Kurth wrote: >> On 16/10/2019, 17:35, "Rich Persaud" wrote: >> On Oct 15, 2019, at 08:27, Lars Kurth wrote: >>> ... >>> >>> My point really was is that due to storing the files in git, we essentially

Re: [Xen-devel] [RFC] Documentation formats, licenses and file system structure

2019-10-17 Thread Stefano Stabellini
On Thu, 17 Oct 2019, Lars Kurth wrote: > On 16/10/2019, 17:35, "Rich Persaud" wrote: > > > On Oct 15, 2019, at 08:27, Lars Kurth wrote: > ... > > > > My point really was is that due to storing the files in git, we > essentially do NOT today do this. > > So we would need to

Re: [Xen-devel] [RFC] Documentation formats, licenses and file system structure

2019-10-17 Thread Lars Kurth
On 16/10/2019, 17:35, "Rich Persaud" wrote: > On Oct 15, 2019, at 08:27, Lars Kurth wrote: ... > > My point really was is that due to storing the files in git, we essentially do NOT today do this. > So we would need to take extra action: e.g. manually or through tooling

Re: [Xen-devel] [RFC] Documentation formats, licenses and file system structure

2019-10-16 Thread Rich Persaud
> On Oct 15, 2019, at 08:27, Lars Kurth wrote: > Hi Rich, > On 15 Oct 2019, at 02:58, Rich Persaud wrote: > On Oct 11, 2019, at 07:11, Lars Kurth wrote: >>> On 11/10/2019, 02:24, "Stefano Stabellini" wrote: On Thu, 10 Oct 2019, Lars Kurth wrote: @Stefano: as you and I

Re: [Xen-devel] [RFC] Documentation formats, licenses and file system structure

2019-10-15 Thread Lars Kurth
Hi Rich, > On 15 Oct 2019, at 02:58, Rich Persaud wrote: > >> On Oct 11, 2019, at 07:11, Lars Kurth wrote: >> >> On 11/10/2019, 02:24, "Stefano Stabellini" wrote: >> >>>On Thu, 10 Oct 2019, Lars Kurth wrote: >>> >>> @Stefano: as you and I believe Brian will be spending time on

Re: [Xen-devel] [RFC] Documentation formats, licenses and file system structure

2019-10-14 Thread Rich Persaud
> On Oct 11, 2019, at 07:11, Lars Kurth wrote: > > On 11/10/2019, 02:24, "Stefano Stabellini" wrote: > >>On Thu, 10 Oct 2019, Lars Kurth wrote: >> * Would we ever include API docs generated from GPLv2 code? E.g. for safety >> use-cases? >> @Stefano, @Artem: I guess this one is for you.

Re: [Xen-devel] [RFC] Documentation formats, licenses and file system structure

2019-10-14 Thread P S
On Oct 11, 2019, at 07:11, Lars Kurth wrote: > > On 11/10/2019, 02:24, "Stefano Stabellini" wrote: > >>On Thu, 10 Oct 2019, Lars Kurth wrote: >> * Would we ever include API docs generated from GPLv2 code? E.g. for safety >> use-cases? >> @Stefano, @Artem: I guess this one is for you. >>

Re: [Xen-devel] [RFC] Documentation formats, licenses and file system structure

2019-10-11 Thread Stefano Stabellini
On Fri, 11 Oct 2019, Lars Kurth wrote: > On 11/10/2019, 02:24, "Stefano Stabellini" wrote: > > On Thu, 10 Oct 2019, Lars Kurth wrote: > > * Would we ever include API docs generated from GPLv2 code? E.g. for > safety use-cases? > > @Stefano, @Artem: I guess this one is for you. >

Re: [Xen-devel] [RFC] Documentation formats, licenses and file system structure

2019-10-11 Thread Stefano Stabellini
On Fri, 11 Oct 2019, Lars Kurth wrote: > On 11/10/2019, 09:32, "Jan Beulich" wrote: > > On 10.10.2019 20:30, Lars Kurth wrote: > > On 10/10/2019, 18:05, "Andrew Cooper" wrote: > > On 10/10/2019 13:34, Lars Kurth wrote: > > > Existing formats and licenses > > > *

Re: [Xen-devel] [RFC] Documentation formats, licenses and file system structure

2019-10-11 Thread Lars Kurth
On 11/10/2019, 09:32, "Jan Beulich" wrote: On 10.10.2019 20:30, Lars Kurth wrote: > On 10/10/2019, 18:05, "Andrew Cooper" wrote: > On 10/10/2019 13:34, Lars Kurth wrote: > > Existing formats and licenses > > * Hypercall ABI Documentation generated from Xen

Re: [Xen-devel] [RFC] Documentation formats, licenses and file system structure

2019-10-11 Thread Lars Kurth
On 11/10/2019, 02:24, "Stefano Stabellini" wrote: On Thu, 10 Oct 2019, Lars Kurth wrote: > * Would we ever include API docs generated from GPLv2 code? E.g. for safety use-cases? > @Stefano, @Artem: I guess this one is for you. > I suppose if we would have a similar issue for

Re: [Xen-devel] [RFC] Documentation formats, licenses and file system structure

2019-10-11 Thread Artem Mygaiev
Hi Lars On Thu, 2019-10-10 at 12:34 +, Lars Kurth wrote: > * Possibly stuff such as > https://urldefense.com/v3/__https://xenbits.xen.org/docs/unstable/support-matrix.html__;!K6dmGCEab4ueJg!lwAwYJi7cUkbX7CUXnOD9i7laj_9xcyafF714u6PO04tu0CYUKDHWBHAy2XD0mvEiA$ > (which is currently GPL-2, >

Re: [Xen-devel] [RFC] Documentation formats, licenses and file system structure

2019-10-11 Thread Jan Beulich
On 10.10.2019 20:30, Lars Kurth wrote: > On 10/10/2019, 18:05, "Andrew Cooper" wrote: > On 10/10/2019 13:34, Lars Kurth wrote: > > Existing formats and licenses > > * Hypercall ABI Documentation generated from Xen public headers > > Format: kerndoc > > License: typically

Re: [Xen-devel] [RFC] Documentation formats, licenses and file system structure

2019-10-10 Thread Stefano Stabellini
On Thu, 10 Oct 2019, Lars Kurth wrote: > * Would we ever include API docs generated from GPLv2 code? E.g. for safety > use-cases? > @Stefano, @Artem: I guess this one is for you. > I suppose if we would have a similar issue for a safety manual > I am also assuming we would want to use sphinx

Re: [Xen-devel] [RFC] Documentation formats, licenses and file system structure

2019-10-10 Thread Lars Kurth
On 10/10/2019, 18:05, "Andrew Cooper" wrote: On 10/10/2019 13:34, Lars Kurth wrote: > Hi all, > > following on from a discussion on IRC and on various other places, I think we need to try and rationalize how we handle documentation. > > What we have now and what we

Re: [Xen-devel] [RFC] Documentation formats, licenses and file system structure

2019-10-10 Thread Andrew Cooper
On 10/10/2019 13:34, Lars Kurth wrote: > Hi all, > > following on from a discussion on IRC and on various other places, I think we > need to try and rationalize how we handle documentation. > > What we have now and what we may get in future > * http://xenbits.xen.org/docs/unstable/ (GPL-2) > *