Notes on OSLC PROMCODE changes
File Names
- Instead of "spec.html", use "promcode-spec".
- Same for "vocab" and "shape".
(This follows the pattern used in the OSLC Open Project specifications, at https://docs.oasis-open-projects.org/oslc-op/.)
- Also, to match the OSLC-OP specifications and the .ttl file name, change "shape" to "shapes". (promcode-shapes)
Styles
- use LiberationSans (including for body text)
- use color #446CAA for headings
[resolution - new .css file, at https://docs.oasis-open.org/templates/css/spec-2020.css]
Text:
Titles: require period (.) after "Version 1.0", before the Part name. Remove space between Part number and colon.
Subtitles - need "Committee Specification Draft 01" below title.
- Remove "Specification URIs" [resoluton: delete lines ]
- change lower case "version" to "stage" in five places (This/Previous/Latest stage; third sentence of "Status:"; Citation format) [resolution: changed text]
- Remove indenting of information on the front page (i.e., remove the
and tags)
[Add Previous stage]
[Set Latest stage properly]
[Set "Latest editor's draft" to point to the correct Part (modified in Part 2, 3)]
[Add Chairs]
[Move Additional documents just below Editors; change title to Additional artifacts]
[Add Related work, add info about the "Informative document" (currently last paragraph of heading stuff) there]
Status - mostly okay; remove "being" from third paragraph - Should be: "This specification is provided under ..."
[Add Key words text] (not done)
[Add citation format block]
[Use new Notices block with Appendix] (not done)
[Add list of TC members - required for public review. (Part 1 only)]
[Add line rule between each section with
tags. This will generate a page break for the PDF.]
(the tag between the OASIS logo and the title should be
to avoid page break there)
[To generate the PDF page breaks, the style file (https://docs.oasis-open.org/templates/css/spec-2020.css) includes "hr{page-break-before: always;}" This does not affect the HTML display, just the PDF generated from it.]
TOC - remove bullets (several methods tested)
1 - (not used)(- brute force manual method: change the tags to to remove the bullets)
2 - better (not used): insert into the