Re: [tab] Specification URIs - Important. Please Watch.

[Patrick Durusau <patrick@durusau.net>]

Mary,

High marks but a couple of suggestions/comments:

URI Generator - Give Link in the video

You skip Generic Version File name in the URI generator example. I can 
guess what that does but might be nice to include that in the example as 
well.

A bit fast on the document that hasn't been uploaded and has no previous 
version. When you say "uploaded" you mean uploaded by *you.* When I hear 
"uploaded," I hear uploaded by me.

Suggest another term. Perhaps documents are "uploaded" by members, 
*posted* by the TC Admin. ? So, until a document has been posted, the 
this version and latest version won't work, if the document has no prior 
posting by the TC admin.

Where a document has previously been "posted" by the TC admin, so there 
is a previous version, then the previous version and latest version both 
resolve. Resolution depends on *posting* by the TC admin.

I had to watch that segment 2 or 3 times to catch what was making me 
stumble. The use of "uploaded" and the implied uploader shifts, at least 
from the perspective of a TC member. (The UI for TC members says "add 
document" but I suspect 99.9% of us think of it as "uploading" a document.)

Need to clip the "dead air" from the end of the presentation.

Thanks for the video!

Hope you are having a great weekend!

Patrick


On 2/21/2010 12:35 AM, Mary McRae wrote:
> Hi everyone,
>
>    As part of my ongoing attempts to eliminate as many of the pain points incurred when submitting a spec for review or ballot as possible, I've created a video that explains:
>
> * why we have specification URIs in the first place
> * the difference between This, Previous and Latest Versions
> * how to properly construct your spec URIs
> * how to test to URIs
> * how to fix your URIs if they're broken
>
> You'll see URIs in action - from an HTML format in a browser to Microsoft Word and OpenOffice Writer.
>
> The most common reason for specs being rejected is that the URIs are incorrect, invalid, or otherwise wrong. The video is about 15 minutes long. Please take the time to watch it and let me know if you found it helpful or if you still have questions.
>
> VIDEO: http://docs.oasis-open.org/templates/videos/URIs.mov
>
> Please watch. And please check your documents prior to submitting to tc-admin@lists.oasis-open.org.
>
> Mary
>
>
> Mary P McRae
> Director, Standards Development
> Technical Committee Administrator
> OASIS: Advancing open standards for the information society
> email: mary.mcrae@oasis-open.org
> web: www.oasis-open.org
> twitter: @fiberartisan  #oasisopen
> phone: 1.603.232.9090
>
> Standards are like parachutes: they work best when they're open.
>
>
>
>
> ---------------------------------------------------------------------
> To unsubscribe from this mail list, you must leave the OASIS TC that
> generates this mail.  Follow this link to all your TCs in OASIS at:
> https://www.oasis-open.org/apps/org/workgroup/portal/my_workgroups.php
>
>
>    

-- 
Patrick Durusau
patrick@durusau.net
Chair, V1 - US TAG to JTC 1/SC 34
Convener, JTC 1/SC 34/WG 3 (Topic Maps)
Editor, OpenDocument Format TC (OASIS), Project Editor ISO/IEC 26300
Co-Editor, ISO/IEC 13250-1, 13250-5 (Topic Maps)