Re: xenbits "official" repo for XTF (was Re: [PATCH 0/2] xtf: add launcher (+1 bugfix)

[Lars Kurth <lars.kurth@citrix.com>]

On 18/07/2016 16:30, "Ian Jackson" <ian.jackson@eu.citrix.com> wrote:

>Lars Kurth writes ("Re: [Xen-devel] xenbits "official" repo for XTF (was
>Re: [PATCH 0/2] xtf: add launcher (+1 bugfix)"):
>> I don't object to a new xtf directory in the docs root per se. I mainly
>> object to how the documents are presented in
>> http://xenbits.xen.org/docs/unstable
>
>The documents under there are generated from xen.git#master.
>
>> As far as I understand, the docs directory structure maps onto headline
>> categories in http://xenbits.xen.org/docs/unstable. Is this correct?
>
>What ?  No.
>
>docs/ is just the HTTP namespace section for documents hosted on
>xenbits.  Its subdirectories currently include:
>
>  - one directory for each existing stable and unstable Xen branch,
>    generated from the in-tree documentation source.
>
>  - some example osstest output, referred to from the osstest.git
>    in-tree README
>
>  - a subdirectory `xcp' which is presumably now obsolete and retained
>    for historical reasons.
>
>It appears that it doesn't have an index.html, so we get a webserver
>directory listing.
>
>> I would only object to creating a new docs/xtf directory,
>> - iff directory structure is exposed in the web index in
>> http://xenbits.xen.org/docs/unstable are linked, and
>
>I don't understand what you are asking.
>
>> - iff there is only one document in this directory now, and
>> - iff this will likely be the case in future.
>
>I'm proposing that the initial contents of the xtf/ directory would be
>the initial contents of the /people/andrewcoop/xen-test-framework/
>directory, only with the titles changed as discussed.
>
>So there would be one `document', which is really an HTML page, called
>index.html, so it would replace the webserver directory listing.

>
>> And I would have the same concern for osstest. If there are several
>> documents already in each, then go ahead and create them.
>
>Is your concern that it is a bad idea to create a directory rather
>than a file ?
>
>I think this is wrongheaded.
>
>It is better to create a directory now, with an index.html.  Otherwise
>it will become difficult to turn it into a directory later.

In that case, forget my objection and go ahead and create the directories.
I clearly don't understand how the docs toolchain works and was assuming
that the docs directory structure gets exposed in the web server index,
without being able to specify an extra indirection. Given that is not the
case, the directory structure does not matter.

Lars

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