OASIS Editorial Resources Group
Maintaining useful resources for Chairs, editors, and contributors in OASIS Open Projects and Technical Committees.
Chet Ensign, chet.ensign@oasis-open.org, Chair
Editor's Resources
Templates and Stylesheets
- Master Templates - Documenting the metadata, standard sections, and other pro forma text common to all OASIS work product templates - https://github.com/oasis-editorial-resources/master-templates
- DocBook Templates - Maintaining stylesheet, authoring instructions, and the methodology for creating and publishing OASIS Committee Specifications and Committee Notes using DocBook XML - https://github.com/oasis-editorial-resources/docbook-templates
- Google Doc Templates - Maintaining stylesheet, templates, and other resources to enable collaborative editing and production of OASIS-styled standards- and non-standards-track work products. - https://github.com/oasis-editorial-resources/googledocs-templates
- DITA Stylesheets - Supporting development and maintenance of the style sheets and other resources that are used to build OASIS-styled publications from DITA source - https://github.com/oasis-open/dita-stylesheets
- ReSpec Stylesheets Supporting development and maintenance of extensions to the ReSpec application to enable it to produce OASIS-styled specifications - TBD
- Coming Soon - Stylesheets and instructions for creating OASIS Specs with markdown
Editor's Manual
- Part 1: Role of the Editor - https://docs.google.com/document/d/1lTartcAzlqidzrCxuXFFiwdRDKRipqMnNsMS24SZdjg/edit#heading=h.bi4fdsq13pue
- Part 2: Editorial Process - https://docs.google.com/document/d/1gaYTQleiGMRA1vt2sLo1YUXqlGJe-JXgukJvSSlOhRI/edit#heading=h.bi4fdsq13pue
- Part 3: Work Product Structure - https://docs.google.com/document/d/1yA-wt2wB4NOpgoQ81VBfuJ1WPA1GK_BuddiVP_L6BnU/edit#heading=h.bi4fdsq13pue
- Part 4: Work Product Preparation - https://docs.google.com/document/d/10lt8f2pn_ebZTsWJiGYiWYzyo6NbjuTskvDcS2tSyPw/edit#heading=h.bi4fdsq13pue
Other Editorial Resources
- Checklist for Verifying the Editorial Quality of OASIS Specifications - https://www.oasis-open.org/committees/download.php/54999/TAB-ReviewChecklist-rev10.html
- Document Submission Checklist - https://www.oasis-open.org/apps/org/workgroup/download.php/47468/
- Keyword Guidelines for OASIS Specifications and Standards - https://www.oasis-open.org/policies-guidelines/keyword-guidelines
- Guidelines to Writing Conformance Clauses for OASIS Specifications - http://docs.oasis-open.org/templates/TCHandbook/ConformanceGuidelines.html
- Proposed Testability Guidelines - https://wiki.oasis-open.org/tab/TestabilityGuide
- Conformance, Interoperability and Portability Testing: Proposed Procedures and Practices - https://wiki.oasis-open.org/tab/TestingPolicy
- Using JIRA for Standards Development - https://www.oasis-open.org/sites/www.oasis-open.org/files/JIRA-for-standards-dev-03-10-14.pdf
- W3C Recommendation Citation List for OASIS Editors - http://docs.oasis-open.org/templates/w3c-recommendations-list/w3c-recommendations-list.html
- IETF RFC Citation List for OASIS Editors - http://docs.oasis-open.org/templates/ietf-rfc-list/ietf-rfc-list.html
- WebConf online chat tool by Doug Davis - http://webconf.soaphub.org/conf/
Chair's Resources
- Best Practices for Meeting Minutes - http://docs.oasis-open.org/templates/TCHandbook/Best-practices-for-meeting-minutes-v1.0.html
- TC Motion Language Templates - https://www.oasis-open.org/committees/download.php/53768
- Standards Workflow Gantt chart in Excel - https://www.oasis-open.org/sites/www.oasis-open.org/files/TC-Process-gantt-chart.xls