myfaces-commits mailing list archives

Site index · List index
Message view « Date » · « Thread »
Top « Date » · « Thread »
Subject cvs commit: incubator-myfaces/src/documentation/content/xdocs site.xml
Date Mon, 10 Jan 2005 07:23:15 GMT
matzew      2005/01/09 23:23:15

  Modified:    src/documentation/content/xdocs site.xml
  Added:       src/documentation/content/xdocs/community issue.xml
                        bylaws.xml status.xml
  forrest stuff
  Revision  Changes    Path
  1.1                  incubator-myfaces/src/documentation/content/xdocs/community/issue.xml
  Index: issue.xml
  <?xml version="1.0" encoding="UTF-8"?>
  <!DOCTYPE document PUBLIC "-//APACHE//DTD Documentation V1.2//EN" "document-v12.dtd">
      <title>Apache MyFaces - Issue Tracking </title>
  <title>Tracking System</title>
        <p>MyFaces uses JIRA for issue tracking.</p>
          <li><link href="">here</link></li>
      	<legal>Java, J2EE, and JCP are trademarks or registered trademarks of Sun Microsystems,
Inc. in the United States and other countries.<br />
  	&copy; 2004, Apache Software Foundation
  1.1                  incubator-myfaces/src/documentation/content/xdocs/community/bylaws.xml
  Index: bylaws.xml
  <?xml version="1.0" encoding="ISO-8859-1"?>
    Copyright 2004 The Apache Software Foundation
    Licensed under the Apache License, Version 2.0 (the "License");
    you may not use this file except in compliance with the License.
    You may obtain a copy of the License at
    Unless required by applicable law or agreed to in writing, software
    distributed under the License is distributed on an "AS IS" BASIS,
    WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
    See the License for the specific language governing permissions and
    limitations under the License.
  <!DOCTYPE document PUBLIC "-//APACHE//DTD Documentation V1.1//EN" "document-v11.dtd">
      <title>Apache MyFaces Project Bylaws</title>
      <section><title>Apache MyFaces Project Bylaws</title>
        <p>This document defines the bylaws under which the Apache MyFaces
        project operates. It defines the roles and responsibilities of
        the project, who may vote, how voting works, how conflicts are
        resolved, etc.</p>
        <p>MyFaces is a project of the <link
        href="">Apache Software
        Foundation</link>.  The foundation holds the copyright on Apache
        code including the code in the MyFaces codebase. The <link
        FAQ</link> explains the operation and background of the
        <p>MyFaces is typical of Apache projects in that it operates under
        a set of principles, known collectively as the "Apache Way". If
        you are new to Apache development, please refer to the <link
        href="">Incubator project</link>
        for more information on how Apache projects operate.</p>
      <section><title>Roles and Responsibilities</title>
        <p>Apache projects define a set of roles with associated rights
        and responsibilities. These roles govern what tasks an
        individual may perform within the project. The roles are defined
        in the following sections.</p>
          <p>The most important participants in the project are people
          who use our software. The majority of our developers start out
          as users and guide their development efforts from the user's
          <p>Users contribute to the Apache projects by providing
          feedback to developers in the form of bug reports and feature
          suggestions. As well, users participate in the Apache
          community by helping other users on mailing lists and user
          support forums.</p>
          <p>All of the volunteers who are contributing time, code,
          documentation, or resources to the MyFaces Project. A developer
          that makes sustained, welcome contributions to the project may
          be invited to become a Committer, though the exact timing of
          such invitations depends on many factors.</p>
          <p>The project's Committers are responsible for the project's
          technical management. All committers have write access to the
          project's source repositories. Committers may cast binding
          votes on any technical discussion regarding the project.</p>
          <p>All Developers who are already committers for any other
          Apache code-base automatically obtain commit access to the
          MyFaces project as well.</p>
          <p>Committer access is by invitation only and must be approved
          by lazy consensus of the active PMC members. A Committer is
          considered emeritus by their own declaration or by not
          contributing in any form to the project for over six
          months. An emeritus committer may request reinstatement of
          commit access from the PMC. Such reinstatement is subject to
          lazy consensus of active PMC members.</p>
          <p>Commit access can be revoked by a unanimous vote of all the
          active PMC members (except the committer in question if they
          are also a PMC member).</p>
          <p>All Apache committers are required to have a signed
          Contributor License Agreement (CLA) on file with the Apache
          Software Foundation. There is a <link
          FAQ</link> which provides more details on the requirements for
          <p>A committer who makes a sustained contribution to the
          project may be invited by or ask the PMC to become a member of
          the PMC. The form of contribution is not limited to code. It
          can also include code review, helping out users on the mailing
          lists, documentation, etc.</p>
        <section><title>Project Management Committee</title>
          <p>The Project Management Committee (PMC) for Apache MyFaces was
          created by a resolution of the board of the Apache Software
          Foundation on 18th February 2004. The PMC is responsible to
          the board and the ASF for the management and oversight of the
          Apache MyFaces codebase. The responsibilities of the PMC
            <li>Deciding what is distributed as products of the Apache
            MyFaces project.  In particular all releases must be approved
            by the PMC.</li>
            <li>Maintaining the project's shared resources, including
            the codebase repository, mailing lists, websites.</li>
            <li>Speaking on behalf of the project.</li>
            <li>Resolving license disputes regarding products of the
            <li>Nominating new PMC members and committers.</li>
            <li>Maintaining these bylaws and other guidelines of the
          <p>Membership of the PMC is by invitation only and must be
          approved by a lazy consensus of active PMC members. A PMC
          member is considered "emeritus" by their own declaration or by
          not contributing in any form to the project for over six
          months. An emeritus member may request reinstatement to the
          PMC. Such reinstatement is subject to lazy consensus of the
          active PMC members. Membership of the PMC can be revoked by an
          unanimous vote of all the active PMC members other than the
          member in question.</p>
          <p>The chair of the PMC is appointed by the ASF board. The
          chair is an office holder of the Apache Software Foundation
          (Vice President, Apache MyFaces) and has primary responsibility
          to the board for the management of the projects within the
          scope of the MyFaces PMC. The chair reports to the board
          quarterly on developments within the MyFaces project.  The PMC
          may consider the position of PMC chair annually and if
          supported by 2/3 Majority may recommend a new chair to the
          board.  Ultimately, however, it is the board's responsibility
          who it chooses to appoint as the PMC chair.</p>
      <section><title>Decision Making</title>
        <p>Within the MyFaces project, different types of decisions require
        different forms of approval. For example, the previous section
        describes several decisions which require "lazy consensus"
        approval. This section defines how voting is performed, the
        types of approvals, and which types of decision require which
        type of approval.</p>
          <p>Decisions regarding the project are made by votes on the
          primary project mailing list ( Where
          necessary, PMC voting may take place on the private MyFaces PMC
          mailing list - this is generally true for votes on people,
          i.e. electing new committers or PMC members or removing these
          rights.  Votes are clearly indicated by subject line starting
          with [VOTE] or [PMC-VOTE]. Votes may contain multiple items
          for approval and these should be clearly separated. Voting is
          carried out by replying to the vote mail. Voting may take four
              <td>"Yes" "Agree," or "the action should be performed." In
              general, this vote also indicates a willingness on the
              behalf of the voter in "making it happen"</td>
              <td>This vote indicates a willingness for the action under
              consideration to go ahead. The voter, however will not be
              able to help.</td>
              <td>This vote indicates that the voter does not, in
              general, agree with the proposed action but is not
              concerned enough to prevent the action going ahead.</td>
              <td>This is a negative vote. On issues where consensus is
              required,this vote counts as a <strong>veto</strong>. All
              vetoes must contain an explanation of why the veto is
              appropriate. Vetoes with no explanation are void. It may
              also be appropriate for a -1 vote to include an
              alternative course of action.</td>
          <p>All participants in the MyFaces project are encouraged to show
          their agreement with or against a particular action by
          voting. For technical decisions, only the votes of active
          committers are binding. Non binding votes are still useful for
          those with binding votes to understand the perception of an
          action in the wider MyFaces community. For PMC decisions, only
          the votes of PMC members are binding.</p>
          <p>Voting can also be applied to changes made to the MyFaces
          codebase. These typically take the form of a veto (-1) in
          reply to the commit message sent when the commit is made.</p>
          <p>These are the types of approvals that can be
          sought. Different actions require different types of
              <td>For this to pass, all voters with binding votes must
              vote and there can be no binding vetoes (-1). Consensus
              votes are rarely required due to the impracticality of
              getting all eligible voters to cast a vote.</td>
              <th>Lazy Consensus</th>
              <td>Lazy consensus requires 3 binding +1 votes and no
              binding vetoes.</td>
              <th>Lazy Majority</th>
              <td>A lazy majority vote requires 3 binding +1 votes and
              more binding +1 votes that -1 votes.</td>
              <th>Lazy Approval</th>
              <td>An action with lazy approval is implicitly allowed
              unless a -1 vote is received, at which time, depending on
              the type of action, either lazy majority or lazy consensus
              approval must be obtained.</td>
              <th>2/3 Majority</th>
              <td>Some actions require a 2/3 majority of active
              committers or PMC members to pass. Such actions typically
              affect the foundation of the project (e.g. adopting a new
              codebase to replace an existing product). The higher
              threshold is designed to ensure such changes are strongly
              supported. To pass this vote requires at least 2/3 of
              binding vote holders to vote +1</td>
          <p>A valid, binding veto cannot be overruled. If a veto is
          cast, it must be accompanied by a valid reason explaining the
          reasons for the veto. The validity of a veto, if challenged,
          can be confirmed by anyone who has a binding vote. This does
          not necessarily signify agreement with the veto - merely that
          the veto is valid.</p>
          <p>If you disagree with a valid veto, you must lobby the
          person casting the veto to withdraw their veto. If a veto is
          not withdrawn, the action that has been vetoed must be
          reversed in a timely manner.</p>
          <p>This section describes the various actions which are
          undertaken within the project, the corresponding approval
          required for that action and those who have binding votes over
          the action.</p>
              <th>Binding Votes</th>
              <th>Code Change</th>
              <td>A change made to a codebase of the project and
              committed by a committer. This includes source code,
              documentation, website content, etc.</td>
              <td>Lazy approval and then lazy consensus.</td>
              <td>Active committers.</td>
              <th>Release Plan</th>
              <td>Defines the timetable and actions for a release. The
              plan also nominates a Release Manager.</td>
              <td>Lazy majority</td>
              <td>Active committers</td>
              <th>Product Release</th>
              <td>When a release of one of the project's products is
              ready, a vote is required to accept the release as an
              official release of the project.</td>
              <td>Lazy Majority</td>
              <td>Active PMC members</td>
              <th>Adoption of New Codebase</th>
              <td>When the codebase for an existing, released product is
              to be replaced with an alternative codebase. If such a
              vote fails to gain approval, the existing code base will
              continue. This also covers the creation of new
              sub-projects within the project</td>
              <td>2/3 majority</td>
              <td>Active committers</td>
              <th>New Committer</th>
              <td>When a new committer is proposed for the project</td>
              <td>Lazy consensus</td>
              <td>Active PMC members</td>
              <th>New PMC Member</th>
              <td>When a committer is proposed for the PMC</td>
              <td>Lazy consensus</td>
              <td>Active PMC members</td>
              <th>Committer Removal</th>
              <td>When removal of commit privileges is
              sought. <strong>Note:</strong> Such actions will also be
              referred to the ASF board by the PMC chair</td>
              <td>Active PMC members (excluding the committer in
              question if a member of the PMC).</td>
              <th>PMC Member Removal</th>
              <td>When removal of a PMC member is
              sought. <strong>Note:</strong> Such actions will also be
              referred to the ASF board by the PMC chair</td>
              <td>Active PMC members (excluding the member in question).</td>
        <section><title>Voting Timeframes</title>
          <p>Votes are open for a period of 1 week to allow all active
          voters time to consider the vote. Votes relating to code
          changes are not subject to a strict timetable but should be
          made as timely as possible.</p>
  1.1                  incubator-myfaces/src/documentation/content/xdocs/community/status.xml
  Index: status.xml
  <?xml version="1.0" encoding="UTF-8"?>
  <!DOCTYPE document PUBLIC "-//APACHE//DTD Documentation V1.2//EN" "document-v12.dtd">
      <title>Apache MyFaces - Status</title>
  <title>Action Item</title>
        <p>MyFaces is in the process of migrating to the Apache Software Foundation.
Once we have passed through the Apache Incubator, MyFaces will become a top-level Apache project.</p>
      	<legal>Java, J2EE, and JCP are trademarks or registered trademarks of Sun Microsystems,
Inc. in the United States and other countries.<br />
  	&copy; 2004, Apache Software Foundation
  1.5       +5 -0      incubator-myfaces/src/documentation/content/xdocs/site.xml
  Index: site.xml
  RCS file: /home/cvs/incubator-myfaces/src/documentation/content/xdocs/site.xml,v
  retrieving revision 1.4
  retrieving revision 1.5
  diff -u -r1.4 -r1.5
  --- site.xml	1 Dec 2004 10:08:11 -0000	1.4
  +++ site.xml	10 Jan 2005 07:23:15 -0000	1.5
  @@ -9,11 +9,16 @@
   	<docu href="docs/" label="Documentation" tab="documentation">
   		<faq label="FAQ" href="faq.html" />
   		<jars label="JARs" href="jars.html" />
  +		<javadoc label="Java Doc" href="" />
  +		<tlddoc label="Taglibs" href="" />
   		<controlprogramming label="Homepage" href="sf.html" />
     <community href="community/" label="Community" tab="community">
       <mailinglists label="Mailing Lists" href="mailinglists.html" />
       <contributors label="Contributors" href="contributors.html" />
  +    <status label="Status" href="status.html" />
  +    <bylaws label="Project Bylaws" href="bylaws.html"/>
  +    <wiki label="Wiki" href=""/>

View raw message