Hi Jim,Â
On this topic, Paul and I talked about it and I also discussed it with the TAB.Â
Our consensus is that you should do your authoring and editing however you find workable; we will do what's needed to add our structure and metadata as part of our publishing process. Since you all are working in an easily manipulated, clear text format (Hallelujah), we should be able to put together a script or two to process the content expeditiously. Patrick Durusau of the TAB has offered to help with that.Â
Patrick and Jacques Durand of the TAB pointed out that the current scheme has been in use going back to 2010, and that it was the result of several years of debate. The majority of the content published on docs.oasis-open.org now conforms to the directives. We just didn't see a compelling reason dramatically change existing, established practice, especially where there are simpler solutions to be had.Â
So my goal is to make it easy for you all to work in a way that makes sense while not disrupting current practice.Â
Let me know if you have any questions on it.Â
Best,Â
/chetÂ
On Thu, Oct 18, 2018 at 11:37 AM Jim Amsden <> wrote:
Chet, any update on this? We're looking
to finish up changes to the 7 part OSLC Core specs and they have quite
a few relative links that will either be broken, or will require manual
updates when published to the OASIS document repository.
I think the primary issue is that we
can't use relative links because the file names get changed when the documents
are published. For example, OSLC Core Vesion 3.0. Part 1: Overview
Committee Specification revision 03 has published URL:
http://docs.oasis-open.org/oslc-core/oslc-core/v3.0/csprd03/part1-overview/oslc-core-v3.0-csprd03-part1-overview.html
However, the actual file name in the
GitHub repo is simply oslc-core.html.
Perhaps OASIS could consider changing
the naming guidelines to not put variable information like version, revision
number and document status in the published file name. This should be unnecessary
because it is also included in the path and results in variable but redundant
information. In the URL above,
oslc-core-v3.0-csprd03-part1-overview.html
is redundant with oslc-core/v3.0/csprd03/part1-overviewin the path. If this redundancy could be eliminated, then the file name
would be unchanged when published, and all relative links would work fine.
If you would like to consider this,
we could certainly change the names of the files to better reflect their
title and part.
Jim Amsden, Senior Technical Staff Member
OSLC and Linked Lifecycle Data
919-525-6575
----------------
Chet Ensign
Chief Technical Community Steward
OASIS: Advancing open standards for the information society
http://www.oasis-open.org
Primary: +1 973-996-2298
Mobile: +1 201-341-1393Â
