OASIS Mailing List ArchivesView the OASIS mailing list archive below
or browse/search using MarkMail.

 


Help: OASIS Mailing Lists Help | MarkMail Help

xdi message

[Date Prev] | [Thread Prev] | [Thread Next] | [Date Next] -- [Date Index] | [Thread Index] | [List Home]


Subject: Chet: WE'RE READY! Final questions to prep for our first Committee Specification Draft vote


Chet,

Chet,

At Monday's XDI TC meeting, the TC members agreed on the final changes that we needed to XDI Core 1.0 Working Draft 05 in order to be ready for a Committee Specification Draft vote.

The editors (Joseph and Markus and I) made those changes and posted Working Draft 06 on Monday night for everyone to review. Everyone is on board with the changes, so Working Draft 06 is now ready for a Committee Specification Draft vote. The official version is in Kavi, but a version you can read with a browser using the stylesheet for rendering is at:

http://xdi.org/xdi-spec-docbook/xdi/xdi-core-1.0/xdi-core-1.0-wd06.xml 

Joseph and I just reviewed the OASIS page you sent us about approving a Committee Specification Draft, but unfortunately it is still not clear on that page whether the ZIP file needs to contain:
  1. Just the source doc (which in our case is DocBook XML) plus any code examples, OR 
  2. The source XML doc plus the PDF and HTML versions of the source XML doc.

If you can clarify that question for us (and possibly also suggest the best name for this ZIP file, since it will be part of the ballot), then Joseph will create the ZIP file and upload it, and Markus and I will start the online vote.

Speaking of which, please also let us know if this is the ballot language we should use or if you have any revisions:

Do you approve XDI Core 1.0 Working Draft 06 and all associated artifacts packaged together in [URL to ZIP file on TC's Kavi document repository] as a Committee Specification Draft and designate the XML version of the document as authoritative.

Finally, is there anything else we need to do before can proceed with the vote?

Thanks,

=Drummond  






On Tue, Oct 6, 2015 at 9:43 AM, Chet Ensign <chet.ensign@oasis-open.org> wrote:
HI Drummond, 

Yes, I noticed that in the last telecon notes. Congrats, this must feel like reaching the final mile of a marathon!  

On your questions:

"Do we need to do anything special to hold a Committee Specification Draft vote? (I suspect you've published something on this—if so just point us to it)."

You can read the instructions on approving a draft at https://www.oasis-open.org/resources/tcadmin/approving-a-committee-specification-or-note-draft . That write-up includes sample motion / ballot language you can use. Since you all are working without meetings, I assume you'll be using the TC's ballot facility right? 

The key considerations in the motion is that you have everything to be published in a Zip file loaded to the TC's document repository and that the title and the the public link to that ZIP file be in the ballot language. That's because I will take that package linked to as the starting point for publication. 

Also, you will need to make sure that your Roster is up to date. Since you are not holding meetings, anyone who is a Member and has been in the TC for more than 60 days has gained voting rights and should be changed to Voting Member in the roles. Taking a quick look at the roster, I suspect that a lot of people there need to be switched over to have voting rights. 

"We are having some challenges with the DocBook template and things like table formatting." 

I'm not experienced with using DocBook so I won't be much help there nor would Paul. I think someone like Ken Holman or perhaps someone on the DocBook TC can be more help. Do you want me to see if I can get someone who can talk with you all and help out? 

A couple of questions from my side: 

- You are just approving a Committee Spec Draft right now, correct? That is, you are not ready yet to send it out for public review? I ask because if you want to go to public review, the document will need the Conformance Clauses section. That isn't required at the draft stage but is for a public review. 

- Are the various documents intended to be independent work products that will advance independently towards Committee Specification and ultimately OASIS Standard? Or is the group envisioning one XDI spec made up of multiple parts? I ask because right now, looking at the templates Paul provided and the Core spec, it looks like each work product will be standalone. If they are intended to be parts of a single spec, we should talk. That will make for a very different naming structure. 

- Joseph is editing correct? Looking at the draft, after approval, what I'll do is work with him on the changes needed to switch it from a working draft to a Commitee Spec Draft. For example, right now, the "This version" links are http://docs.oasis-open.org/xdi/spec-1.0/xdi-core-1.0-wd05.xxx - that's actually an error and will need to be either 


or 


Changes like that. 

- Oh right - last question. I noticed that the draft has lots of code examples and then it includes where appear to be normative code - e.g. Appendix A Collected ABNF. The TC Process in section 2.18 says:

(7) Computer Language Definitions. All normative computer language definitions that are part of the Work Product, such as XML instances, schemas and Java(TM) code, including fragments of such, must be well formed and valid.

(7a) For Standards Track Work Products:

  • All normative computer language definitions must be provided in separate plain text files;
  • Each text file must be referenced from the Work Product; and
  • Where any definition in these separate files disagrees with the definition found in the specification, the definition in the separate file prevails.

If the ABNF meets this definition (and since I have other specs with ABNF files, I figure it must), then any that meet this will also need to be provided as separate standalone files. 

Whew. That's all I can think of for now. If you want to talk about any of this, let me know. I'll keep an eye out as you move forward with this. And again, congratulations! 

Best, 

/chet


On Tue, Oct 6, 2015 at 2:44 AM, =Drummond Reed <drummond@respect.network> wrote:
Chet,

After 11 years (the XDI TC was chartered in 2004), we are preparing for our first Committee Specification Draft vote on XDI Core 1.0. Joseph Boyle is finishing the conversion of the different spec sections from different authors into right now, and we plan to hold the vote starting Monday Oct 19, so it is finished before Internet Identity Workshop (Oct 27-29).

Two questions for you:
  1. Do we need to do anything special to hold a Committee Specification Draft vote? (I suspect you've published something on this—if so just point us to it).
  2. We are having some challenges with the DocBook template and things like table formatting. Can we arrange a call sometime in the next 2 weeks with you and/or others at OASIS who are expert in the subject so we can get these ironed out? (The good news is that once we have it worked out for the first spec, the next 9 after that will be much simpler).
Thanks,

=Drummond  



--

/chet 
----------------
Chet Ensign
Director of Standards Development and TC Administration 
OASIS: Advancing open standards for the information society
http://www.oasis-open.org

Primary: +1 973-996-2298
Mobile: +1 201-341-1393 



[Date Prev] | [Thread Prev] | [Thread Next] | [Date Next] -- [Date Index] | [Thread Index] | [List Home]