This is an archived snapshot of W3C's public bugzilla bug tracker, decommissioned in April 2019. Please see the home page for more details.

Bug 5341 - EPR Reference Scheme Note
Summary: EPR Reference Scheme Note
Status: RESOLVED FIXED
Alias: None
Product: SML
Classification: Unclassified
Component: EPR Reference Scheme (show other bugs)
Version: unspecified
Hardware: PC Windows XP
: P2 normal
Target Milestone: CR
Assignee: Kirk Wilson
QA Contact: SML Working Group discussion list
URL:
Whiteboard:
Keywords: hasProposal, needsAgreement
Depends on:
Blocks:
 
Reported: 2008-01-03 21:12 UTC by Kirk Wilson
Modified: 2009-06-08 16:54 UTC (History)
3 users (show)

See Also:


Attachments
comments on latest proposal (126.50 KB, application/msword)
2008-04-20 20:23 UTC, John Arwe
Details
Len's proposed edits to the Note on EPR-based ref schemes (60.98 KB, application/vnd.openxmlformats-officedocument.wordprocessingml.document)
2009-02-26 03:27 UTC, Len Charest
Details
Len's proposed edits to the Note on EPR-based ref schemes (357.16 KB, application/pdf)
2009-02-26 03:27 UTC, Len Charest
Details
Kirk's responses to Len's edits (Word doc.) (70.30 KB, application/vnd.openxmlformats-officedocument.wordprocessingml.document)
2009-03-01 16:56 UTC, Kirk Wilson
Details
Kirk's Responses to Len's Comments (PDF format) (330.63 KB, application/pdf)
2009-03-01 17:07 UTC, Kirk Wilson
Details
Second version of revisions (Word doc) (54.90 KB, application/vnd.openxmlformats-officedocument.wordprocessingml.document)
2009-03-05 16:29 UTC, Kirk Wilson
Details
Second version of revisions (PDF format) (333.92 KB, application/pdf)
2009-03-05 16:36 UTC, Kirk Wilson
Details
comments on Kirk's draft, docx (48.20 KB, application/vnd.openxmlformats-officedocument.wordprocessingml.document)
2009-03-20 12:27 UTC, John Arwe
Details
comments on Kirk's draft, pdf (142.06 KB, application/x-download)
2009-03-20 12:27 UTC, John Arwe
Details
Revisions in response to John's comments 665 (DOC version) (48.50 KB, application/vnd.openxmlformats-officedocument.wordprocessingml.document)
2009-03-27 14:36 UTC, Kirk Wilson
Details
Revisions in response to John's comments 666 (PDF version) (294.04 KB, application/pdf)
2009-03-27 14:40 UTC, Kirk Wilson
Details
Attachment 671 with consistent format for textual references (55.74 KB, application/vnd.openxmlformats-officedocument.wordprocessingml.document)
2009-04-06 11:28 UTC, Kirk Wilson
Details
Attachment 672 with consistent format for textual references (285.41 KB, application/pdf)
2009-04-06 11:31 UTC, Kirk Wilson
Details
Checked version of EPR Note (HTML) (53.53 KB, text/html)
2009-05-01 11:00 UTC, Kirk Wilson
Details
Corrections for comment #31 (53.47 KB, text/html)
2009-05-12 10:08 UTC, Kirk Wilson
Details
Links to SML and SML-IF Recommendations (53.49 KB, text/html)
2009-05-15 10:08 UTC, Kirk Wilson
Details
Addresses Len's Comment #34 (53.59 KB, text/html)
2009-06-03 00:06 UTC, Kirk Wilson
Details

Description Kirk Wilson 2008-01-03 21:12:18 UTC
Compose a W3C Note on the EPR Reference Scheme
Comment 1 Kirk Wilson 2008-01-20 13:05:23 UTC
Initial draft of the EPR Note for discussion at the Orlando F2F:

http://lists.w3.org/Archives/Public/public-sml/2008Jan/0087.html
Comment 2 Kirk Wilson 2008-03-18 14:45:51 UTC
Initial draft of the SML EPR Reference Scheme Note is attached in the following email:
http://lists.w3.org/Archives/Public/public-sml/2008Mar/0019.html
Comment 3 Kirk Wilson 2008-03-18 14:48:35 UTC
Comments by Ginny on initial draft of the SML EPR Reference Scheme Note are attached to this email:
http://lists.w3.org/Archives/Public/public-sml/2008Mar/0072.html
Comment 4 Kirk Wilson 2008-03-18 14:50:47 UTC
Revised draft of the SML EPR Reference Scheme Note, based on Ginny's comments, is attached this email:
http://lists.w3.org/Archives/Public/public-sml/2008Mar/0076.html
Comment 5 Kirk Wilson 2008-03-18 20:19:00 UTC
Follow-up comments by Ginny are contained in the following email:
http://lists.w3.org/Archives/Public/public-sml/2008Mar/0078.html
Comment 6 Kirk Wilson 2008-03-20 17:12:36 UTC
Clean-up draft based on Ginny's last comments; also containing minor edits, is attached to the following email:
http://lists.w3.org/Archives/Public/public-sml/2008Mar/0081.html
Comment 7 Kirk Wilson 2008-04-10 18:49:53 UTC
New draft based on comments received at the Redwood City F2F:

http://lists.w3.org/Archives/Public/public-sml/2008Apr/0057.html
Comment 8 Kirk Wilson 2008-04-14 23:01:26 UTC
Please ignore draft attached to Comment #7.  The replacement draft is attached to the following email:

http://lists.w3.org/Archives/Public/public-sml/2008Apr/0063.html
Comment 9 John Arwe 2008-04-20 20:23:42 UTC
Created attachment 548 [details]
comments on latest proposal

my comments on the latest epr note draft
Comment 10 Kirk Wilson 2008-04-24 15:37:43 UTC
Version in response to Comment #9 can be found attached to the following email:

http://lists.w3.org/Archives/Public/public-sml/2008Apr/0139.html
Comment 11 Kirk Wilson 2008-10-21 10:27:24 UTC
Email with latest draft attached, prepared for discussion at Oct 27 - 29 F2F:

http://lists.w3.org/Archives/Public/public-sml/2008Oct/0012.html
Comment 12 John Arwe 2008-12-02 00:52:33 UTC
(In reply to comment #11)
> Email with latest draft attached, prepared for discussion at Oct 27 - 29 F2F:
> 
> http://lists.w3.org/Archives/Public/public-sml/2008Oct/0012.html
> 

PDF version at http://lists.w3.org/Archives/Public/public-sml/2008Oct/0016.html
Comment 13 Len Charest 2009-01-15 19:39:27 UTC
Note has been converted to HTML and put under version control in CVS. See http://dev.w3.org/cvsweb/2007/xml/sml/epr-note.html.
Comment 14 Len Charest 2009-02-26 03:27:00 UTC
Created attachment 642 [details]
Len's proposed edits to the Note on EPR-based ref schemes

Open in word 2007
Comment 15 Len Charest 2009-02-26 03:27:49 UTC
Created attachment 643 [details]
Len's proposed edits to the Note on EPR-based ref schemes

Open with a PDF reader
Comment 16 Len Charest 2009-02-26 03:34:33 UTC
I've attached my proposed changes to the EPR note. There are quite a few, but most are style changes.

Change tracking is on in the Word doc, so insertions and deletions are visible. Deletions are marked in red with a strike-through line. Insertions are double-underlined. Where I have replaced text, the insertion always follows the deletion and there is an explanatory comment attached to the insertion.
Comment 17 Kirk Wilson 2009-03-01 16:56:48 UTC
Created attachment 648 [details]
Kirk's responses to Len's edits (Word doc.)

Corrections made in response to Len's comments.  Some discussion points remain.
Comment 18 Kirk Wilson 2009-03-01 17:07:04 UTC
Created attachment 649 [details]
Kirk's Responses to Len's Comments (PDF format)
Comment 19 Kirk Wilson 2009-03-05 16:29:56 UTC
Created attachment 654 [details]
Second version of revisions (Word doc)

Accepted changes from 648 (comment #17) and applied clean-up changes plus changes as discussed on telecon of 2009-03-02.  Also, this draft uses IRIs rather than URIs in conjunction with the WS-Addressing spec.  (If this useage is unacceptable, it can be backed-out easily.)
Comment 20 Kirk Wilson 2009-03-05 16:36:14 UTC
Created attachment 655 [details]
Second version of revisions (PDF format)

PDF version corresponding to attachment 654 [details] / comment #19.
Comment 21 John Arwe 2009-03-20 12:27:16 UTC
Created attachment 665 [details]
comments on Kirk's draft, docx

comments on Kirk's draft, docx
Comment 22 John Arwe 2009-03-20 12:27:51 UTC
Created attachment 666 [details]
comments on Kirk's draft, pdf

comments on Kirk's draft, pdf
Comment 23 Kirk Wilson 2009-03-22 14:28:58 UTC
Notes on John's Comments.

JA2: There is also a place where reference to RFC 3986 is bolded rather italicized as well.

JA3: I would suggest dropping the "(in theory)".  I think the "may be possible to define" is sufficient to allow the "in theory" case.

JA4: "Implementation-defined" should be dropped.
Comment 24 Kirk Wilson 2009-03-27 14:36:37 UTC
Created attachment 671 [details]
Revisions in response to John's comments 665 (DOC version)

Revisions in response to John's comments (attachment 665 [details]).  Only two passages were significant changed.  Please read for FINAL review.
Comment 25 Kirk Wilson 2009-03-27 14:40:28 UTC
Created attachment 672 [details]
Revisions in response to John's comments 666 (PDF version)

Revisions in response to John's comments (attachment 666 [details] - PDF version).  Only two passages were significantly changed.  Please read for FINAL review.
Comment 26 Kirk Wilson 2009-04-06 11:28:26 UTC
Created attachment 677 [details]
Attachment 671 [details] with consistent format for textual references

Clean-ups textual references from 671, establishes a consistent format for references.
Comment 27 Kirk Wilson 2009-04-06 11:31:58 UTC
Created attachment 678 [details]
Attachment 672 [details] with consistent format for textual references

Cleans-up textual references for 672; applies consistent formating to references.
Comment 28 John Arwe 2009-04-06 13:44:08 UTC
We'll probably want to adjust the References text ala the AC comments on the Rec track documents (XML 4th edition being the "sore point").  Although I don't remember much in the way of reviews on Notes, there's no point in poking organizations in the eye either.  Something along the lines of "the references are consistent with those used in the development of the SML and SMLIF specs" at the top, coupled with "floor=SML Rec track references, ceiling=latest" should mollify folks based on what we've seen to date.
Comment 29 Kirk Wilson 2009-05-01 11:00:38 UTC
Created attachment 689 [details]
Checked version of EPR Note (HTML)

Links to the SML and SML-IF specs are not guaranteed to work in this version until these specs are published.
Comment 30 Kirk Wilson 2009-05-01 11:03:46 UTC
Completed Checking of EPR Note: PubRules, CSS-Validator, HTML Checker, Link Checker.

Most recent version attached to But and available at

http://dev.w3.org/cvsweb/~checkout~/2007/xml/sml/epr-note.html?rev=1.12
Comment 31 Virginia Smith 2009-05-11 15:55:12 UTC
Review of document:
- [SML] links do not work.
- [address] link in paragraph *after* 2.1.3.c does not work.
- In the same paragraph, I suggest a link to "target-complete identifier" definition.
- "thesame" - in last paragraph in section 2
- "ot" section 4.2, first paragraph
Comment 32 Kirk Wilson 2009-05-12 10:08:10 UTC
Created attachment 694 [details]
Corrections for comment #31

Corrections to Ginny's comments in Comment #31.
Comment 33 Kirk Wilson 2009-05-15 10:08:36 UTC
Created attachment 697 [details]
Links to SML and SML-IF Recommendations

Updated all hyperlinks to SML and SML-IF to the 20090512 Recommendation versions.
Comment 34 Len Charest 2009-06-01 05:02:55 UTC
Running the link checker (http://validator.w3.org/checklink) over revision 1.14 reveals many broken links, particularly links to the SML and SML-IF recommendations. Many of the intra-doc fragment ids are broken as well.

In the References section:

  - The [SML] and [SML-if] entries have '25 November 2008' as the date of 
    publication
  - [RFC 3987] could use a comma and space after the title
  - [WS-Man] -- There is a problem with the markup around the title
  - [WS-T] and [WSDM] -- Replace period after title with a comma
  - [XML] contains what looks like a placeholder '[XXXSMLXXX]'; also, is
    the explanatory text re editions necessary here?

Suggest bumping up the date on the Note and adjusting the Note URIs to match. I changed the XLink Note to '1 June 2006'.

The hover-to-reveal behavior of the 'Back to Contents' links is broken.
Comment 35 Kirk Wilson 2009-06-03 00:06:32 UTC
Created attachment 704 [details]
Addresses Len's Comment #34

All issues identified by Len in Comment #34 are addressed.
Comment 36 John Arwe 2009-06-08 16:54:58 UTC
Per the telecon of June 1, the working group has decided it has finished its work on this Note. http://lists.w3.org/Archives/Public/public-sml/2009Jun/att-0003/20090601-sml-minutes.html#item04

Per the telecon of June 8, I am closing out this bug.