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@lists.xen.org https://lists.xen.org/xen-devel