Initial documentation for ReSpec conformance clause handling

["Nicholas Crossley" <nick_crossley@us.ibm.com>]

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.

Attachment: Conformance Clauses in ReSpec 1.docx
Description: application/vnd.openxmlformats-officedocument.wordprocessingml.document

.conformance {
    background-color: #E9FFBE;
 }

.conformance-label {
    text-transform:     lowercase;
    font-variant:       small-caps;
    font-style:         normal;
    color:              #00B900;
 }

 table.conformance-table {
	border: 1px solid gray;
	border-collapse: collapse;
	border-spacing: 0px;
	padding-left: 0.5em;
	padding-right: 1em;
	padding-top: 3px;
	padding-bottom: 0px;
	vertical-align: top;
}

table.conformance-table td {
	border: 1px solid gray;
	border-collapse: collapse;
	border-spacing: 0px;
	padding-left: 0.5em;
	padding-right: 2em;
	padding-top: 3px;
	padding-bottom: 0px;
	vertical-align: top;
}

table.conformance-table th {
	border: 1px solid gray;
	border-collapse: collapse;
	border-spacing: 0px;
	padding-left: 0.5em;
	padding-right: 2em;
	padding-top: 4px;
	padding-bottom: 2px;
	vertical-align: middle;
	text-align: left;
	font-weight: bold;
}