[UA-discuss] Proposal: Handling Numbering of the UASG Documents

Fri Jan 25 10:50:51 UTC 2019

On 25 Jan 2019, at 07:18, Asmus Freytag (c) <asmusf at ix.netcom.com<mailto:asmusf at ix.netcom.com>> wrote:

On 1/24/2019 10:55 PM, Don Hollander wrote:
So you would want the main link to be:

https://uasg.tech/documents/UASG000-Inventory-of-Material EN.pdf<https://uasg.tech/documents/UASG000-Inventory-of-Material%20EN.pdf>

And the filename to be

https://uasg.tech/documents/UASG000-Inventory-of-Material EN 2019 01 25.pdf<https://uasg.tech/documents/UASG-000-Inventory-of-Material%20EN%202019%2001%2025.pdf>

Yep.

For Unicode, the main link for technical reports even drops the file extension (usually html for TRs), so in your example:

https://uasg.tech/documents/UASG000-Inventory-of-Material EN<https://uasg.tech/documents/UASG000-Inventory-of-Material%20EN.pdf>

if that can be realized.

(Unicode, the way they do it, piggybacks on the "index.html" technique which would not be apropos here, so if the extension has to be retained it's not that critical).

A,/

PS: I find file names with spaces are still a pain for some tools, so I suggest adding some hyphens.

Why not have the filenames in the language of the document thus giving a link such as: uasg.tech/documents/UASG000-инвентарь-материала<http://uasg.tech/documents/UASG000-инвентарь-материала> or uasg.tech/documents/UASG000-инвентарь-материала-2019-01-25

I have purposely dropped the language tag ru as a person who understands Russian would understand the filename in the link. This is inline with the common practice on websites for the language names to be written in that language and script eg wikipedia and twitter

I know it adds complications but I consider it much more in the spirit of internationalisation.

André Schappo

From: UA-discuss <ua-discuss-bounces at icann.org><mailto:ua-discuss-bounces at icann.org> On Behalf Of Asmus Freytag (c)
Sent: Friday, 25 January 2019 7:30 PM
To: Don Hollander <don.hollander at icann.org><mailto:don.hollander at icann.org>; Tex <textexin at xencraft.com><mailto:textexin at xencraft.com>; ua-discuss at icann.org<mailto:ua-discuss at icann.org>
Subject: Re: [UA-discuss] Proposal: Handling Numbering of the UASG Documents

I would expect to be able to leave the date off the link and get the latest file version. Depending on technology that gets implemented with soft link, redirection or duplicate copy, but for the user, that is immaterial, all that counts is being able to ignore the revision date.

I would expect each document to carry such a generic link to the "latest" version in a header or a note somehwere, so that no matter what copy of the document you are accessing (based some reference somewhere) you are always able to discover the existence of later versions.

I would expect the revision notes to have a link for each date, so one can backtrack versions without going through the archive.

Otherwise, this is beginning to take shape.
A./

On 1/24/2019 9:45 PM, Don Hollander wrote:
Thanks.

How’s this?

  *   Document Number (e.g. UASG000) – this will be maintained as a consistent reference name for a document.  NB: No hyphen in the document number.
  *   Document Short Title (e.g. UASG000 Inventory of Material) – this will be included in the file name.
  *   Document Language (e.g. UASG000 Inventory of Material EN) – this will be included in the file name.
  *   Document Revision – (e.g. UASG000 Inventory of Material  EN  2019-01-25) This will be based on the publication date and represented in the file name as yyyy-mm-dd.  It will also be included within the document.
  *   Document Link – (e.g. https://uasg.tech/documents/UASG000-Inventory-of-Material EN 2019 01 25.pdf<https://uasg.tech/documents/UASG-000-Inventory-of-Material%20EN%202019%2001%2025.pdf> ) This will be based on the language of the document and is what’s published on the UASG.Tech website and will retrieve the latest official version of the document.
  *   Archives: The UASG.tech<http://uasg.tech/> website will include a repository of deprecated versions of documents that will be stored and displayed based on its file name (which will include the published date)
  *   Revision Details: For most documents we will maintain a table at the end showing a summary of revisions.  Where a document is used a brochure, this will not be done.

Revision Notes:
2019-01-25

Added Document Naming and Storage Conventions

2018-12-25

Added expected review dates

From: UA-discuss <ua-discuss-bounces at icann.org><mailto:ua-discuss-bounces at icann.org> On Behalf Of Tex
Sent: Friday, 25 January 2019 1:23 PM
To: 'Asmus Freytag' <asmusf at ix.netcom.com><mailto:asmusf at ix.netcom.com>; ua-discuss at icann.org<mailto:ua-discuss at icann.org>
Subject: Re: [UA-discuss] Proposal: Handling Numbering of the UASG Documents

Thanks for the clarification Asmus. I agree with you, brochures shouldn’t have revision histories.

I had noticed the one place where Jim used the word “reservation” and thought your second sentence was independent from the first, and commenting on that-
“I have reservations about embedding text like "wp-content/uploads/" in the official document link”

So it’s all good.
Tex

From: UA-discuss [mailto:ua-discuss-bounces at icann.org] On Behalf Of Asmus Freytag
Sent: Thursday, January 24, 2019 4:10 PM
To: ua-discuss at icann.org<mailto:ua-discuss at icann.org>
Subject: Re: [UA-discuss] Proposal: Handling Numbering of the UASG Documents

On 1/24/2019 2:55 PM, Tex wrote:
PS: Brochures, by their nature are different from the kind of reports and formal documents that need careful version tracking in the document. I disagree with Jim on his reservation.

This was about whether revisions are documented inside the document. Don, suggested not, and I would agree. I think of brochures as a type of document, not a technology, but may have misunderstood something.

A./

🌏 🌍 🌎
André Schappo
小山@电邮.在线?Subject=你好小山😜<mailto:%E5%B0%8F%E5%B1%B1@%E7%94%B5%E9%82%AE.%E5%9C%A8%E7%BA%BF?Subject=%E4%BD%A0%E5%A5%BD%E5%B0%8F%E5%B1%B1%F0%9F%98%9C>
schappo.blogspot.co.uk<https://schappo.blogspot.co.uk>
twitter.com/andreschappo<https://twitter.com/andreschappo>
weibo.com/andreschappo?is_all=1<https://weibo.com/andreschappo?is_all=1>
groups.google.com/forum/#!forum/computer-science-curriculum-internationalization<https://groups.google.com/forum/#!forum/computer-science-curriculum-internationalization>

-------------- next part --------------
An HTML attachment was scrubbed...
URL: <http://mm.icann.org/pipermail/ua-discuss/attachments/20190125/2f8025b0/attachment.html>