W3C home > Mailing lists > Public > www-xkms@w3.org > June 2004

Re: updated specification

From: Shivaram Mysore <shivarammysore@yahoo.com>
Date: Thu, 10 Jun 2004 14:37:26 -0700 (PDT)
Message-ID: <20040610213726.85221.qmail@web51508.mail.yahoo.com>
To: jose.kahan@w3.org
Cc: www-xkms@w3.org

Jose, 

Comments inline ...

 

Hi,I worked a bit on the spec and uploaded it to our site.Shivaram, in order to simplify the publishing process and make it easier to upload the drafts, I'm proposing a new publishing model:- Previously, we had to upload a complete set of the specs, including  images and so on everytime we change something. I propose  that we now work directly on a single draft of the specs, and just  indicate in the change log what was modified (more about this below).  I created the following web space:	http://www.w3.org/2001/XKMS/Drafts/XKMS-PR-DRAFT/  and made a copy of the CR specs and put your edited version there   too: http://www.w3.org/2001/XKMS/Drafts/XKMS-PR-DRAFT/PR-DRAFT-xkms-part-1.html http://www.w3.org/2001/XKMS/Drafts/XKMS-PR-DRAFT/PR-DRAFT-xkms-part-2.htmlI think this will make editing the spec much more easier. And there'salways CVS to look at the previous versions.

Agreed.  I will work on the PR-DRAFT-* docs.

Some other propositions on how to edit the document:- Shivaram, you were leaving the previous text and using the HTML  <strike> tag to indicate what you removed. As it is also important  to know what was added, I propose we use <del> instead of  <strike> and <ins> to show what new text was added. This is what  other working groups are doing. I already made the changes to   the document you had sent us and that's what I uploaded.

Thanks a lot for making this change.  I will do so from now on.  That is simple enough to do.

- When we make new editions to the draft, we just have to update  the date and <del> the previous one, so that we can keep a track  of what we did.- I added an Appendix for the changes, but didn't fill it out yet. We  have to report there all the changes to the document since the CR that  were not minor edits. I need to coordinate with you to get it right  this time, just to be sure that I know which issues you answered.  This Change section is required by the process document. It will  mostly parrot the issues list.

All the open issues open so far except the new one which will get filed due to bob@example.com is fixed as per suggestion.

- I added links from the XKMS home page pointing to the drafts and  tried to group the different links into sections, so that they are  (hopefully) clearer to understand.   http://www.w3.org/2001/XKMS/With respect your pending messages:> 1.  Work with Jose to fix the boiler plate at the top of the specification.I did some changes, so that we point to the previous version, and newone. If I can think on a better boiler plate, I'll let you know :)

Thanks

> 2.  How should the contributors to the specification post CR be acknowledged in the specification.  I was planning on adding another list to the exisiting one in the spec.  Suggestions welcome.We can inspire ourselves from other specs. I've not looked at this yet.> 3.  If Jose can update the issues list by 30 May, we can then release the updated spec and the issues list at the same time.I have to know which issues were fixed. I'm working on that, trying toget it ready before the meeting... but I may not make it today :-/

See above - all issues opened so far with the exception of the new one that will get filed has been fixed.

-jose

Thanks for all the hard work Jose.  Much appreciated.

/Shivaram


		
---------------------------------
Do you Yahoo!?
Friends.  Fun. Try the all-new Yahoo! Messenger
Received on Thursday, 10 June 2004 17:37:56 UTC

This archive was generated by hypermail 2.3.1 : Tuesday, 6 January 2015 20:31:42 UTC