Re: [Xen-devel] STAO spec in xen.git

[Andrew Cooper <andrew.cooper3@xxxxxxxxxx>]

On 17/01/17 04:55, Juergen Gross wrote:
> On 16/01/17 19:40, Stefano Stabellini wrote:
>> On Mon, 16 Jan 2017, Ian Jackson wrote:
>>> Stefano Stabellini writes ("Re: STAO spec in xen.git"):
>>>> In that case, I think we should still commit it as ODT, but convert it
>>>> automatically to PDF when we publish it (we do something similar with
>>>> the markdown docs, converting them from markdown to html).
>>> Exactly.
>>>
>>> The fact that git diff won't show updates well is not ideal, but IMO
>>> it is imperative to get the document 1. it into our own version
>>> control and 2. in a format we can edit 3. using FLOSS tools.
>>>
>>> Please can we commit the source of the document to xen.git as a first
>>> step.  At that point the xen.git copy will become the master copy.
>>>
>>> We can then think about PDF export.  If the conversion has to be done
>>> ad hoc manually at first then that is not a blocker for committing the
>>> file.
>> Right. I am going to commit this version for now.
>>
>> If somebody was willing to come up with an alternative version of this
>> document in a more git-friendly format, I would be more than happy for
>> it to replace the ODT version.
> LaTeX? Should be less than 1 hour work. I can do it if a .tex file is
> okay.

We have had LaTeX documents in the past in tree.  It certainly would be
more text-friendly.

~Andrew

_______________________________________________
Xen-devel mailing list
Xen-devel@xxxxxxxxxxxxx
https://lists.xen.org/xen-devel