[OASIS Issue Tracker] (OSLCCORE-31) Vocabulary files for ReSpec are not the same as the OSLC published namespace vocabulary files

[OASIS Issues Tracker <workgroup_mailer@lists.oasis-open.org>]

    [ https://issues.oasis-open.org/browse/OSLCCORE-31?page=com.atlassian.jira.plugin.system.issuetabpanels:comment-tabpanel&focusedCommentId=60555#comment-60555 ] 

Nick Crossley commented on OSLCCORE-31:
---------------------------------------

I think that is the right way to manage the vocabulary document.

Step 3 actually involves processing the Turtle source into the HTML human-readable version, storing those two documents somewhere (in the real standard, this must be in the OASIS document library), and setting up the redirect from open-services.net/ns. The 3.0 version must be compatible with the 2.0 version, since vocabulary URIs have no versions; we can add terms, clarify the meaning of existing terms, and possibly add vs:term_status values to the terms, but we cannot remove terms or make any incompatible changes to existing terms.

See also https://issues.oasis-open.org/browse/OSLCCORE-25

> Vocabulary files for ReSpec are not the same as the OSLC published namespace vocabulary files
> ---------------------------------------------------------------------------------------------
>
>                 Key: OSLCCORE-31
>                 URL: https://issues.oasis-open.org/browse/OSLCCORE-31
>             Project: OASIS OSLC Lifecycle Integration Core (OSLC Core) TC
>          Issue Type: Bug
>            Reporter: James Amsden
>            Assignee: James Amsden
>
> The OSLC Core vocabulary files are partitioned by OASIS multi-part specification document so they can be used in the Terms section in each document. However Core has only one ontology namespace, so these are all multi-parts of a single ontology (which wouldn’t have multiple labels). This may include merging content from the core2 vocabulary. When the vocabulary is published, all these files will need to be merged, along with any contribution from OSLC Core 2.0 into a single oslc-core.ttl vocabulary that is published on open-services.net/ns.
> As a result, the files used to generate the Terms section in the specifications and the file used to publish the definitive vocabulary for the OSLC namespace are different. That can be managed. But it might be useful to consider:
> 1. merge these files once
> 2. store a single file in SVN
> 3. publish a OSLC Specification version of that file to the open-service.net namespace
> 4. create a single specification document that contains the full vocabulary as one of the multi-part specification documents
> 5. Update the Terms sections in the other specification documents to include a brief summary of terms introduced in that section with a URL link to an appropriate anchor element in the Terms document.
> This would eliminate any potential discrepancies between the specification and published namespace documents, simplify document management of OSLC Core, and provide the vocabulary HTML view in a single document instead of spread over many documents.



--
This message was sent by Atlassian JIRA
(v6.2.2#6258)