OASIS Committee Public Pages

Guidelines for creating and maintaining public pages for OASIS Committees

  1. Overview
  2. Committee Public Home Page
  3. Other Committee Public Pages
  4. Subcommittee Public Pages
  5. Templates
  6. General Tips for Creating and Maintaining Pages

1. Overview

The OASIS website is an objective, vendor-neutral resource reserved for information on the Consortium and its work. Readers include potential Committee members, including those interested in implementing the work of the Committee, editors, industry analysts, and others. Readers' familiarity with OASIS and with the work of the Committees varies from novice to expert.

The following guidelines are provided to:

  • help Committees identify content that would be useful to readers

  • ensure all Committee pages provide content in a consistent format, so readers can easily locate information of interest

  • identify content that is not appropriate for placement on a Committee home page and direct readers to alternate locations

  • ensure that the visibility requirements of the OASIS TC Process Section 2.8 are met, i.e., "All web pages, documents, ballot results, and email archives of all TCs and Subcommittees shall be publicly visible."

2. Committee Public Home Page

The main purpose of a Committee public home page is to provide basic information on the work of the TC to educate readers, encourage participation, and promote adoption. Although appropriate content may vary based on the needs of each Committee, some basic elements of information are common to all TCs. Identifying and presenting this common information in a clear, consistent format will make it easier for the public and the press to understand a Committee's work. Basic information common to all OASIS Committees includes:


HEADER

The following information is created by OASIS staff or autogenerated by Kavi; requests to edit should be made through TC Admin.

Page title:

Complete TC name including acronym (if any)

Yellow box:

Brief statement of purpose
Name and email of Committee Chairs, Secretaries, and TC Admin

Right purple nav box:

Charter
IPR Statement
FAQ
Membership
Email Archives
Comment Archive
Documents
Schedule
Minutes
Press

Right column:

List of Foundational Sponsors and Sponsors participating in the Committee


BODY COPY

Committee chairs or Secretaries are responsible for providing up-to-date content on the body of the public home page. Edits are made through the members-only TC page in the "Group Notes" box using the OASIS Committee Public Homepage Template. The template consists of boilerplate sections, sample text, and comments describing the intended purpose of each component of the overall template. Instructions for using the template are also provided.

The template organizes Committee information into the following groupings:

  • Announcements

  • Overview

  • Subcommittees

  • Technical Work Produced by the Committee

  • Expository Work Produced by the Committee

  • External Resources

  • Mailing Lists and Comments

  • Additional Information


FOOTER

The footer should consist of a brief statement to credit TC homepage editor (optional) and provide email for technical assistance:

"Content for this OASIS TC web page is provided by <name> of <organization (if OASIS organizational member)> on behalf of the TC. For technical assistance, contact webmaster@oasis-open.org."


3. Other Public TC Pages

Charter
This page contains the charter and a link to the TC's original Call for Participation. It is generated by TC Admin.

IPR Statement
This page states the IRP Mode under which the TC operates as well as declarations regarding IPR related to the work of the TC. It is generated by TC Admin.

FAQ
This page provides common questions and answers; it is written by the TC and posted and maintained by the OASIS webmaster. Edits to this page are made by TC instruction to communications@oasis-open.org.

Membership
This page lists the members and voting members of the TC. A link to a page listing Obligated Members is also provided. Both pages are generated by Kavi.

Email Archives
This is an automatically generated page providing the publicly accessible archives of the TC's member mail list.

Comment Archive
This is an automatically generated page providing the publicly accessible archives of the TC's public comment mail list.

Documents
This page provides access to all documents posted by the TC.

Schedule
All TC chairs are strongly encouraged to use this Kavi calendar tool to schedule Committee meetings, conference events, and other milestones.

Minutes

Press
This page provides links to published news articles on the work of the Committee. The page is maintained by OASIS staff. TC chairs and members are encouraged to send suggestions for articles that should be posted to communications@oasis-open.org.

4. Subcommittee Public Pages

If a TC has one or more Subcommittees (SCs), each SC must have its own public home page containing information or links to information on the following items pertaining to the SC:

  • Overview

  • Technical Work Produced by the Subcommittee

  • Expository Work Produced by the Subcommittee

  • Members

  • Email archives

  • Other publicly accessible SC web pages (if any)

5. Templates

Committee Public Home Page Template
In order to maintain a consistent format, OASIS provides a template for use on all TC public home pages. TC chairs or Secretaries should download this template, create or update content, then copy and paste the content into the "Notes" field on the "Edit Group Notes" members-only page. Instructions for using template are also provided.

FAQ Template
The OASIS Technical Advisory Board provides an FAQ template for use by all TCs. This template provides common questions that are applicable to most TCs. TCs may expand on these basic FAQs to address additional issues specific to their work. This template is provided to chairs by the TC Admin.

6. General Tips for Creating and Maintaining Public Pages

  • Whenever possible, embed hyperlinks inside text instead of making them visible. This will make the page appear cleaner, more engaging, and easier to scan.

  • Ensure all links provided point to publicly accessible pages; do not insert links to OASIS members-only pages on the Committee's public pages.