OASIS-oasis-editorial-resources@ConnectedCommunity.org

Contacts

Chair: Chet Ensign
chet.ensign@oasis-open.org

Charter

Statement of purpose:
The OASIS Editorial Resources group, along with the companion GitHub organization, is a central location for assets to help OASIS technical community members - editors, open source developers, chairs - work effectively within the OASIS model. It also acts as a locus for those who want to manage tools a place to do so.

The group is owned and managed by the OASIS Technical Community Steward. All OASIS members and Open Project contributors are welcome to join and participate.

IPR
Work taking place or made available in this group is covered by the Non-assertion Mode of the OASIS IPR Policy

Audience:

Committee Chairs, specification editors, Open Project contributors, style sheet and publishing tool maintainers

Description

Maintaining useful resources for Chairs, editors, and contributors in OASIS Open Projects and Technical Committees.

Group Notes

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