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

[Ian Jackson <ian.jackson@xxxxxxxxxxxxx>]

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.

> If there is a link between directory structure and web index, my preferred
> alternative to creating the two separate directories would be to group all
> the test related documents into a docs/testing directory.

I think you are confused.

> It would be helpful to users and newcomers if all test related documents
> could be found under a Testing headline in
> http://xenbits.xen.org/docs/unstable/

This is certainly not possible because the url you quote is generated
from xen.git.

Ian.

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