Re: [oslc-domains] Initial documentation for ReSpec conformance clause handling

[Chet Ensign <chet.ensign@oasis-open.org>]

Hi Nick, 

I will have an OASIS TAB-hosted GitHub open project set up for you all before the end of the week. I will have both the issues list and the wiki turned on. Will let you know as soon as it is available. 

Best, 

/chet

On Tue, Jul 3, 2018 at 4:50 AM, Nicholas Crossley <nick_crossley@us.ibm.com> wrote:

Fellow OSLC TC members,

As discussed in meetings last week, I spent some time updating ReSpec to generate conformance sections and clauses, and I completed initial testing of those changes early this week. One thing that I said I would do, but have not, is to number the conformance clauses relative to the section number in which they appear. I ran out of time to complete that work, so the numbering is purely sequential across one entire source file. Since such numbering is not stable anyway, it will not break anything if I improve that in the future.

Formatting is done using CSS styles with a default stylesheet 'conformance.css' built into ReSpec - if necessary, you could override those with styles you provide.

I have not yet had time to convert/upload my notes on the changes to a wiki, so I'm including them as a Word document attached to this email. At some point, we should set up the OASIS ReSpec wiki - but possibly not until we have a truly permanent home for it, not in my personal github account.

Since we now have a ReSpec that can generate documents acceptable to OASIS staff without considerable manual post-processing, and since the changes in this new rev were quite significant, I have updated the version number from 0.3.x to 1.0.0.

The last stable version in the 0.3.x line is 0.3.8. The versions 0.3.9 and 0.3.10 were intermediate builds for testing while running from the github server, and should be ignored. If you want to revert, use 0.3.8.

I welcome comments, questions, and other feedback.

Nick.




---------------------------------------------------------------------
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

--

/chet 
----------------

Looking forward to Borderless Cyber 2018, 3-5 Oct, Washington, D.C.

Organized by The World Bank, OASIS, and Georgetown University

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