Re: [PATCH 0/3] docs: User oriented documentation

[Andrew Cooper <andrew.cooper3@citrix.com>]

On 20/03/2019 11:20, Wei Liu wrote:
> On Tue, Mar 19, 2019 at 04:20:04PM +0000, Andrew Cooper wrote:
>> This is a project I've been musing over for a long time now, to try and
>> address Xen's almost complete absense of documentation.
>>
>> This series, plus some other in-progress conversion of the command line doc,
>> is available to view at:
>>
>>   https://andrewcoop-xen.readthedocs.io/en/latest/
>>
>> This is read-the-docs's automatic CI build of documentation from a branch on
>> gitlab.  Observe that the docs don't look like they are out of the 90's, and
>> are automatically translated into PDF and ePUB format as well.
>>
>> In due course I'll see about updating xenbits.xen.org/docs to render this as
>> well, but I don't have sufficient tuits at the moment.
>>
>> Andrew Cooper (3):
>>   docs/sphinx: Skeleton setup
>>   docs/rst: Use pandoc to render ReStructuredText
>>   docs/admin-guide: Boot time microcode loading
> I don't think these changes introduce new dependencies in the build.
> Assuming my observation is correct:
>
> Acked-by: Wei Liu <wei.liu2@citrix.com>

In the short term, no.  In due course, we'll need virtualenv and a bit
more integration for anyone wanting to build the sphinx tree locally,
but I'm fairly sure we get virtualenv automatically by already having
python as a build dependency.

~Andrew

_______________________________________________
Xen-devel mailing list
Xen-devel@lists.xenproject.org
https://lists.xenproject.org/mailman/listinfo/xen-devel