Re: [xdi-editors] questions about browser-viewable copies on xdi.org

["=Drummond Reed" <drummond.reed@xdi.org>]

This makes sense to me. So this is my understanding of how we will proceed during the spec drafting process:

1. The editor team for each spec decides when it wants to put out a new Working Draft (and each WD has its own number).
   
2. When an editor team publishes a new WD, 4 things happen:
1. The new WD Docbook file is added to Github.
2. The same file (as I understand it) is copied to the OASIS Kavi system.
3. The browser-renderable version of the Docbook file is posted to the XDI.org servers along with the necessary CSS info.
4. A link to #3 is added/updated to the XDI One Specs page on the wiki.

Do I have this right?

If so, once the editors on this list have signed off on this, I suggest we document this process on the XDI One Specs page so everyone knows how it works.

On Fri, Nov 21, 2014 at 8:42 AM, Markus Sabadello <markus.sabadello@xdi.org> wrote:

Hmm I think the idea of the wiki might have been to only point to "done" working drafts (wd), i.e. the wiki points to xdi-core-1.0-wd02.xml, while somewhere in Github there is currently work being done on xdi-core-1.0-wd03.xml.

So maybe now that I have done some work on messaging and binding, perhaps their wd number can be increased, and the wiki can point to the "done" wd (02), while new work continues on the "next" wd (03).

Markus

On Fri, Nov 21, 2014 at 5:00 PM, Davis, Peter <Peter.Davis@neustar.biz> wrote:

Git is the official document repository. the xdi.org server is merely a convenience joseph set up which allows a browser to properly load the xml document and the associated style sheet(s).

sounds like we need to update the wiki to point to all of the specifications.

=peterd

On Nov 21, 2014, at 4:58 AM, Markus Sabadello <markus.sabadello@xdi.org> wrote:

I'm again confused how we use the Github repo, XdiOneSpecs wiki page, Kavi, and xdi.org hosted documents in the spec writing process.

In Github we have xdi-core-1.0-wd02.xml, xdi-bindings-1.0-wd02.xml, xdi-messaging-1.0-wd02.xml

On the XdiOneSpecs wiki page, why do we only have a link to xdi-core-1.0-wd02.xml, but not to the others?

On the xdi.org server there is even xdi-core-1.0-wd03.xml, which is neither in Github on the master branch, nor on the XdiOneSpecs wiki page .

On the xdi.org server in /usr/share/nginx/xdi.org/xdi-spec-docbook, I tried to do a "git pull" to get the lastet versions of everything in the master branch, but there are uncommitted local changes, so the "git pull" doesn't work. Why do we manually edit the working drafts on the xdi.org server?

Markus