Skip to main content

AsciiDoc Working Group Charter

v0.7 - Version history is at the end of document

Vision and Scope

The AsciiDoc Working Group will drive the standardization, adoption, and evolution of the AsciiDoc language. This effort will include tools to comprehend, analyze, and transform this language for use in creating technical communication encoded in AsciiDoc. Our goal is to support the development, deployment, management, and usage of software documentation, applications, and services that use AsciiDoc.

To execute this mission, the Working Group will:

  • Foster the design and development of the AsciiDoc language specification, which includes the syntax, rules, built-in attributes, Abstract Semantic Graph (ASG), DOM (Document Object Model), API and options, conversion model, referencing system, extension SPI, and runtime-agnostic technology compatibility kit (TCK), all to ensure interoperability and portability of information encoded in AsciiDoc.
  • Collaborate with Working Group members, contributors, subject matter experts, and community members from multiple domains to select and define capabilities, terminology, and syntax for AsciiDoc based on tangible and emerging use cases, requirements, and important external developments.
  • Support the development of associated technical specifications, compatible implementations, tools, and software libraries.
  • Encourage an extensible architecture, pattern reuse, interface consistency, ease of use and customization, enterprise-level frontend and backend performance, and secure programmatic practices.

Additionally, the Working Group will:

  • Promote the AsciiDoc brand and its value in the marketplace.
  • Provide vendor neutral marketing and other services to the AsciiDoc ecosystem.
  • Leverage the Eclipse Foundation Specification Process to formalize the specifications that are developed within the scope of this Working Group.
  • Establish compatibility rules—including a compatibility and branding process for specification implementations—to ensure application portability and usage patterns that remain consistent with the AsciiDoc model.
  • Leverage Eclipse-defined licensing and intellectual property flows that encourage community participation, protect community members, and promote usage of AsciiDoc and its ecosystem.
  • Manage the overall technical and business strategies of AsciiDoc and its related open source projects.
  • Establish and drive a funding model that enables this Working Group and its community to operate on a sustainable basis.

All Members must be parties to the Eclipse Foundation Membership Agreement, including the requirement set forth in Section 2.2 to follow the Bylaws and then-current policies of the Eclipse Foundation, including but not limited to the Intellectual Property and Antitrust Policies.

Governance and Precedence

Applicable Documents

In the event of any conflict between the terms set forth in this Working Group's Charter and the Eclipse Foundation Bylaws, Membership Agreement, Eclipse Development Process, Eclipse Industry Working Group Process, or any policies of the Eclipse Foundation, the terms of the Eclipse Foundation Bylaws, Membership Agreement, process, or policy shall take precedence.

Membership

With the exception of Guest members as described below, an entity must be at least a Solutions Member of the Eclipse Foundation, have executed the Eclipse AsciiDoc Participation Agreement once defined, and adhere to the requirements set forth in this Charter to participate.

There are three classes of AsciiDoc Working Group membership - Partner, Commiter, and Guest. Each of these classes is described in detail below.

The participation fees associated with each of these membership classes are shown in the Annual Participation Fees section. These are annual fees, and are established by the AsciiDoc Steering Committee, and will be updated in this charter document accordingly.

The fees associated with membership in the Eclipse Foundation are separate from any Working Group membership fees, and are decided as described in the Eclipse Bylaws and detailed in the Eclipse Membership Agreement.

Classes of AsciiDoc Membership

Partner members

Partner Members are organizations that view open technical communication standards and technologies as strategic to their organization and are investing significant resources to sustain and shape the activities of this Working Group. These organizations need open technical communication standards and technologies to deliver their products or services and want to participate in the development of an open technical communication ecosystem. 

Partner Members of the AsciiDoc Working Group must be at least Solutions Members of the Eclipse Foundation.

Committer members

Committer Members are individuals who through a process of meritocracy defined by the Eclipse Development Process are able to contribute and commit content or code to the Eclipse Foundation projects included in the scope of this Working Group. Committers may be members by virtue of working for a member organization, or may choose to complete the membership process independently if they are not. For further explanation and details, see the Eclipse Committer Membership page.

Guest members

Guest Members are organizations which are Associate members of the Eclipse Foundation who have been invited for one year, renewable, by the Steering Committee to participate in particular aspects of the activities of the Working Group. Typical guests include R&D partners, universities, academic research centers, etc. Guests may be invited to participate in committee meetings at the invitation of the respective committee, but under no circumstances do Guest members have voting rights. Guest members are required to execute the Eclipse AsciiDoc Participation Agreement.

Membership Summary

  Partner Member Committer Member Guest Member
Member of the Steering Committee Appointed Elected N/A

Governance

This Working Group is designed as:

  • a member driven organization,
  • a means to foster a vibrant and sustainable ecosystem of components and service providers,
  • a means to organize the community of each project or component so that users and developers define the roadmap collaboratively.

In order to implement these principles, the Steering Committee has been defined (also referred to as the "Body" below) as described below:

  • The Steering Committee must fulfill the responsibilities of the Specification Committee as defined in the Eclipse Foundation Specification Process.

Steering Committee

Powers and Duties

Steering Committee members are required to:

  • Define and manage the strategy of the Working Group.
  • Review and approve this charter.
  • Define and manage which Eclipse Foundation projects are included within the scope of this Working Group, and for those projects that are specification projects, they agree to adhere to the Eclipse Foundation Specification Process.
  • Define and approve the specification process to be used by the AsciiDoc specifications.
  • Ensure that all software projects and specification projects operate in an open, transparent, and vendor-neutral fashion in compliance with the Eclipse Development Process and Eclipse Foundation Specification Process, respectively.
  • Work with the AsciiDoc Project Management Committee (AsciiDoc PMC) to ensure that the specification process is complied with by all AsciiDoc specification projects.
  • Approve specifications for adoption by the community. In this context, the Steering Committee takes the role of the Specification Committee for purposes of implementing the Eclipse Foundation Specification Process.
  • Define and manage the roadmaps.
  • Review and approve the trademark policy to ensure compatibility of independent implementations of specifications.
  • Define the trademark and branding policy to be used by the AsciiDoc specification.
  • Ensure the consistency of logo usage and other marketing materials.
  • Define the budget and fees for all classes of Working Group membership.
  • Invite Guest members to participate in the Working Group.

Composition

  • Each Partner Member of the Working Group has one appointed seat on the Steering Committee.
  • Three elected seats are allocated to Committer Members. Committer Member seats are allocated following the Eclipse "Single Transferable Vote", as defined in the Eclipse Bylaws.

Meeting Management

The Steering Committee meets at least twice a year.

Common Dispositions

The dispositions below apply to all governance bodies for this Working Group, unless otherwise specified. For all matters related to membership action, including without limitation: meetings, quorum, voting, electronic voting action without meeting, vacancy, resignation or removal, the terms set forth in Section 6 of the Eclipse Foundation Bylaws apply.

Good Standing

A representative shall be deemed to be in Good Standing, and thus eligible to vote on issues coming before the Body they participate in, if the representative has attended (in person or telephonically) a minimum of three (3) of the last four (4) Body meetings (if there have been at least four meetings). Appointed representatives on the Body may be replaced by the Member organization they are representing at any time by providing written notice to the Steering Committee. In the event a Body member is unavailable to attend or participate in a meeting of the Body, they may send a representative and may vote by proxy, which shall be included in determining whether the representative is in Good Standing. As per the Eclipse Foundation Bylaws, a representative shall be immediately removed from the Body upon the termination of the membership of such representative’s Member organization.

Voting

For actions (i) requesting that the Eclipse Foundation Board of Directors approve a specification license; (ii) approving specifications for adoption; (iii) amending the terms of the Working Group’s participation agreement; (iv) approving or changing the name of the Working Group; and (v) approving changes to annual Member contribution requirements; any such actions must be approved by no less than two-thirds (2/3) of the representatives in Good Standing represented at a committee meeting at which a quorum is present.

Term and Dates of Elections

All representatives shall hold office until their respective successors are appointed or elected, as applicable. There shall be no prohibition on re-election or re-designation of any representative following the completion of that representative’s term of office.

Partner Members

Partner Member Representatives shall serve in such capacity on committees until the earlier of their removal by their respective appointing Member organization or as otherwise provided for in this Charter.

Elected representatives

Elected representatives shall each serve one-year terms and shall be elected to serve from April 1 to March 31 of each calendar year, or until their respective successors are elected and qualified, or as otherwise provided for in this Charter. Procedures governing elections of Representatives may be established pursuant to resolutions of the Steering Committee provided that such resolutions are not inconsistent with any provision of this Charter.

Meetings Management

Place of meetings

All meetings may be held at any place that has been designated from time-to-time by resolution of the corresponding Body. All meetings may be held remotely using phone calls, video calls or any other means as designated from time-to-time by resolution of the corresponding Body.

Regular meetings

No Body meeting will be deemed to have been validly held unless a notice of same has been provided to each of the representatives in Good Standing at least ten (10) calendar days prior to such meeting, which notice will identify all potential actions to be undertaken by the Body at the Body meeting. No representative will be intentionally excluded from Body meetings and all representatives shall receive notice of the meeting as specified above; however, Body meetings need not be delayed or rescheduled merely because one or more of the representatives cannot attend or participate so long as at least a quorum of the Body is represented at the Body meeting. Electronic voting shall be permitted in conjunction with any and all meetings of the Body the subject matter of which requires a vote of the Body to be delayed until each such representative in attendance thereat has conferred with his or her respective Member organization as set forth in Section Voting above.

Actions

The Body may undertake an action only if it was identified in a Body Meeting notice or otherwise identified in a notice of special meeting.

Invitations

The Body may invite any member to any of its meetings. These invited attendees have no right of vote.

AsciiDoc Working Group Annual Participation Fees

The AsciiDoc Working Group shall not charge members any fees in 2020. The Steering Committee will establish a fee structure; fees will be due beginning with calendar year 2021. The fees are based on the resource requirements needed to achieve the group's objectives, to be described in the working group’s program plan and budget.

AsciiDoc Partner Member Annual Participation Fees

Partner members are required to execute the Eclipse AsciiDoc Participation Agreement. Partner members will pay no participation fees in 2020.

AsciiDoc Committer Member Annual Participation Fees

Committer members pay no annual fees, but are required to execute the Eclipse AsciiDoc Participation Agreement.

AsciiDoc Guest Member Annual Participation Fees

Guest members pay no annual fees, but are required to execute the Eclipse AsciiDoc Participation Agreement.


Charter Version History

  • v0.1 created April 28, 2019.
  • v0.2 updated August 1, 2019.  Minor edits 
  • v0.3 updated February 7, 2020. Update of fees
  • v0.4 updated April 4, 2020.  Minor edits
  • v0.5 updated June 4, 2020. Eliminate Strategic Member class. Change Participant Member class name to Partner Member. Each Partner Member appoints one representative to the Steering Committee. Eliminate 2020 membership fees. Reserve three Steering Committee seats for Committer Members. Update meeting notice from 30 days to 10 days
  • v0.6 updated June 16, 2020. Clarify that basis for fees must be described in the working group’s plan and budget. Reiterate that the Steering Committee’s responsibilities include those of the Specification Committee as defined by the Eclipse Foundation Specification Process.
  • v0.7 updated July 21, 2020. Charter ratified by AsciiDoc Steering Committee

Back to the top