OASIS Mailing List ArchivesView the OASIS mailing list archive below
or browse/search using MarkMail.

 


Help: OASIS Mailing Lists Help | MarkMail Help

sca-j message

[Date Prev] | [Thread Prev] | [Thread Next] | [Date Next] -- [Date Index] | [Thread Index] | [List Home]


Subject: Proposal from TCAdmin to expedite our upload/PR requests


All,

The TCAdmin has made a proposal (below) to expedite our upload/PR requests. Let's discuss this on tomorrow's call:

The biggest reason for the delay in processing the requests per the TCAdmin is due to the fact that the docs are hosted on docs.oasis-open.org. The TCAdmin (Chet) has proposed that we can instead host it in KAVI (OASIS repo) in a special folder and send that link out (www.oasis-open.org/...) for PR. TCAdmin will still do the QA on the docs and docs for CS and OS will still be on docs.oasis-open.org.

I think this will work fine, but there are a few issues:
1) Since KAVI assigns the URL when the doc is uploaded, there is no way to reliably predict what the URL of the spec is going to be apriori. This means we can't have 'This Version' and 'Latest Version' links in the doc. This also means that previously published docs' latest version links won't fetch the latest PR version.

2) If there is a cross-reference then this will be a problem for the same reason as above. In our spec, we do have cross-references but they are non-normative. CAA does not have any normative ref on any other Java spec, but has a non-normative ref to CAA test cases. POJO refers to CAA spec normatively and has a non-normative ref to POJO test cases
CAA TCs have a normative ref to CAA.
POJO TCs have a normative ref to POJO.

To solve the problem in (1) above, I would like to suggest that we ask the TC admin to include two links in the cover page: one to docs.oasis-open.org where the final standard will live and another to the special folder to get the latest non-final PR version.

To solve the problem in (2) above, I would like to suggest that for the non-normative references in the CAA and POJO spec we refer to an earlier version of the testcases and not the latest.

Please let me know what you think. With the suggestions above we can get the PR done faster. OTOH, if we believe that this round is truly the last round and we are willing to wait, then we can do what we have done before and use the TCAdmin proposal for the next version (if there is one).

Let's discuss this tomorrow.

-Anish
--


[Date Prev] | [Thread Prev] | [Thread Next] | [Date Next] -- [Date Index] | [Thread Index] | [List Home]