[incubator] branch master updated: Only include policy on the policy pages

[jm...@apache.org]

This is an automated email from the ASF dual-hosted git repository.

jmclean pushed a commit to branch master
in repository https://gitbox.apache.org/repos/asf/incubator.git


The following commit(s) were added to refs/heads/master by this push:
     new e55f00b  Only include policy on the policy pages
     new f621b04  Merge pull request #15 from justinmclean/master
e55f00b is described below

commit e55f00b2b736916b07cd9058f1b7dbd7acf5addc
Author: Justin Mclean <jm...@apache.org>
AuthorDate: Thu Jul 25 12:35:35 2019 +1000

    Only include policy on the policy pages
---
 pages/policy/incubation.ad | 233 +++++++--------------------------------------
 pages/policy/process.ad    |  73 --------------
 2 files changed, 34 insertions(+), 272 deletions(-)

diff --git a/pages/policy/incubation.ad b/pages/policy/incubation.ad
index 25b6efa..ba9b394 100644
--- a/pages/policy/incubation.ad
+++ b/pages/policy/incubation.ad
@@ -7,12 +7,12 @@ Apache Incubator PMC
 :toc:
 :imagesdir: ../images/
 
-In October 2002 the Board of Directors of the Apache Software Foundation passed a resolution creating the Apache Incubator PMC (referred to as the "Incubator PMC" in this document) charged with "accepting new products into the Foundation, providing guidance and support to help each new product engender their own collaborative community, educating new developers in the philosophy and guidelines for collaborative development as defined by the members of the Foundation, and proposing to the [...]
+In October 2002 the Board of Directors of the Apache Software Foundation passed a resolution creating the Apache Incubator PMC (referred to as the "Incubator PMC") charged with "accepting new products into the Foundation, providing guidance and support to help each new product engender their own collaborative community, educating new developers in the philosophy and guidelines for collaborative development as defined by the members of the Foundation, and proposing to the board the promot [...]
 
-The Incubator was tasked with the following responsibilities (reference Board Resolution):
+The Incubator was tasked with the following responsibilities:
 
 - the acceptance and oversight of new products submitted or proposed to become part of the Foundation;
-- providing guidance and ensuring that subprojects under its purview develop products according to the Foundation's philosophy and guidelines for collaborative development; and
+- providing guidance and ensuring that podlings under its purview develop products according to the Foundation's philosophy and guidelines for collaborative development; and
 - regularly evaluating products under its purview and making the determination in each case of whether the product should be abandoned, continue to receive guidance and support, or proposed to the board for promotion to full project status as part of an existing or new Foundation PMC; and be it further.
 
 == About this Document
@@ -30,119 +30,50 @@ This document is the normative set of requirements for Incubation. Where other d
 == Changing this Document
 The contents of this document are formally approved by the Incubator PMC. All changes must be authorised by the Incubator PMC.
 
-== Objectives of the Process
-To provide a clear path for potential projects and sub-projects within the ASF to move from proposal stage through to fully membership in such as way as to ensure:
-- new projects and sub-projects are developing products according to the ASF's philosophy and guidelines for collaborative development;
-- the ownership of any code initially submitted by the project is formally and legally transferred to the ASF; and
-- only those products that meet Apache's requirements are fully accepted into the ASF.
-
-=== Overview of the Process
-The incubation process covers the establishment of a candidate, acceptance (or rejection) of a candidate leading to the potential establishment of a Podling and associated incubation process, which ultimately leads to the establishment of a new Apache Top-Level-Project (TLP) or sub-project within an existing Apache Project.
-
-image::incubation-process.png[Incubation Process]
-
-== Entry to Incubation
-Please read the link:/guides/entry.html[guide] to the process in conjunction with this policy.
-
-In order to enter the Incubator, a Candidate MUST
-
-- be nominated for incubation by a member of the Apache Software Foundation (The Champion); and
-- be approved by a Sponsor.
-
-=== Proposal
-To start the approval process, a proposal MUST be submitted to the Sponsor. Please read the link:/guides/proposal.html(Guide For Proposals).
-
-=== Approval of Proposal by Sponsor
-The decision to approve the candidate proposal MUST be taken on a vote by the Sponsor, in accordance with that Entity's charter.
-
-=== Acceptance By Incubator
-Upon a successful result, the PMC Chair of the Sponsor SHOULD request that the Incubator PMC take on the Candidate as a new Podling.
-
-However when the Sponsor is the Incubator PMC, then they were the group of people who just voted. So the normal vote summary is sufficient.
-
-Otherwise the Sponsor is an existing top-level project PMC, which now needs to notify the Incubator PMC. The request, which should be sent to the Incubator PMC on the link:/howtoparticipate.html#Mailing+lists[general] list, MUST contain the following information:
-
-- a reference to the results of the vote (so as to provide an audit trail for the records);
-- a reference to the Candidate's proposal;
-- the Mentors, nominated by the Sponsor, who will guide the Candidate through the Incubation Process. At least one nominated Mentor MUST be a member of the Apache Software Foundation.
-
-Any Incubator PMC member can send an acknowledgement that the request was received, then a 72 hour waiting period starts. After this time has elapsed and no Incubator PMC member objects, the status file may be committed and the podling started.  If any Incubator PMC member says "hold" before the 72 hours are up, a formal discussion/vote will be conducted.
-
-==== Acceptance of Mentors
-
-The nominated Mentors MAY be immediately accepted by the Incubator PMC. However the Incubator PMC MAY also suggest replacement Mentors.  The Incubator PMC has the final choice of Mentors.
-
-=== Creation of Podling
-Upon acceptance by the Incubator PMC, the Candidate becomes a Podling under the care of the Incubator PMC.
-
-Upon acceptance by the Incubator PMC, the Podling's Mentor becomes a member of the Incubator PMC (should they not already be one).
-
-== Incubation Activities
-The following sections detail the minimum activities that must be undertaken by the various parties during an Incubation process.
-
-=== Setting Up a New Podling
-
-Once a proposal has been link:#acceptance_by_incubator[accepted] and the podling link:#creation_of_podling[created] the Mentor SHOULD initiate the creation of:
-
-- the link:/guides/mentor.html#Overview[podling metadata] and the reporting schedule;
-- the link:#ongoing_activities[project status] page;
-- the mailing lists;
-- the repository space;
-
-Your project's mentors are able to undertake many of the setup tasks. See link:/guides/mentor.html[the mentor guide] for guidelines about the setup process.  See notes about how to https://www.apache.org/dev/infra-contact[request project resources] such as new committer accounts and new mailing lists. (Note that a committer account will not be created link:http://www.apache.org/dev/pmc.html#newcommitter[until the Contributor License Agreement (CLA) has been recorded.]
-
-The source code that comes into the ASF as part of the podling project must pass through the IP clearance process; details are in the mentor guide linked above.
-
-Your project committers/PPMC members need to become familiar with the link:http://www.apache.org/dev/#infrastructure[ASF Infrastructure information] and in particular the link:http://www.apache.org/dev/#pmc[PMC] notes. Also see the link:/guides/pmc.html[Incubator PMC Guide]
-
-=== Ongoing Activities
-The progress of a Podling SHALL be tracked in a "project status" document. This SHALL be stored in http://svn.apache.org/repos/asf/incubator/public/trunk/content/projects/ and so become available at https://incubator.apache.org/projects/
-
-The "project status" document SHALL include the following minimum content :
-
-- status of setup tasks;
-- all exit criteria (see link:#Exiting_the_Incubator[Exiting the Incubator]);
-- status of Podling against exit criteria.
-
-The Mentors MUST ensure that the "project status" document is up to date at all times. See these link:/guides/website.html#Edit+your+project+status+page[instructions].
-
-
-=== Review of Activity
+== Podling Reporting
 Each Podling in Incubation SHALL undergo a regular review of progress by the Incubator PMC. Podling SHALL report monthly for their first 3 months, after that such reviews SHALL occur at least quarterly. The Incubator PMC MAY, at their discretion, choose to review individual Podlings with greater frequency. The Incubator PMC SHALL inform Podlings of review dates at least 4 weeks in advance.  At least one week prior to each review, the Mentor MUST produce a report for the Incubator PMC det [...]
 
 - that the Podling be Terminated;
 - that the Podling continue in Incubation; or
 - that the Podling be Graduated from Incubation.
 
-Termination and Graduation are discussed in more detail in section "Graduating from the Incubator".
-
-=== Disputing an Assessment
-If the Podling or Mentor disagree with an assessment, they MAY request the Incubator PMC review the report. Such a request MUST include a details of what the Podling and/or Mentor is disputing, and their reasons for doing so.  Upon receipt of an Assessment Dispute, the Incubator PMC SHALL review the request and provide feedback to the Podling and Mentor. Such feedback MAY include a change to the original Assessment.
+== Podling Constraints
+While in Incubation, Podlings are constrained in the actions they can undertake.
 
-Should the Podling and/or Mentor still disagree with the contents of the report, they MAY appeal to the Board of the Apache Software Foundation. Such an appeal MUST include
+=== Website
+Please consult the guide to link:/guides/sites.html[Podling Websites] for the current policies for websites.
 
-- the original assessment;
-- the request for review to the Incubator PMC;
-- the response from the Incubator PMC; and
-- the reason the Podling and/or Mentor still dispute the report.
+=== Branding
+Please consult the guide to link:/guides/branding.html[Podling Branding].
 
-The Board of the Apache Software Foundation MAY, after reviewing the appeal, choose to
+=== Publicity
+Please consult the guide to link:/guides/publicity.html[Podling Publicity].
 
-- amend the incubation Assessment;
-- validate the assessment of the Incubator PMC; or
-- take any other action it deems appropriate to the circumstance.
+== Disclaimers
 
-The decision of the Board of the Apache Software Foundation is final.
+Podling web sites MUST include a clear disclaimer on their
+website and in all documentation, releases and release announcements
+stating that they are in incubation. Podlings SHOULD use the following 
+text for all disclaimers (replace the underlined phrases as appropriate):
 
-=== Continuation
-A recommendation by the Incubator PMC for continuation of incubation SHALL include development recommendations. The Incubator PMC SHALL ensure that the recommended actions are tangible and quantifiable.
-The Mentor SHALL review the contents of the continuation recommendation and ensure that the development recommendations are carried out over the following review period.
+[quote]
+____
+Apache [.underline]#Podling-Name# is an effort
+undergoing incubation at The Apache Software Foundation (ASF),
+sponsored by the [.underline]#name of Apache TLP sponsor#. Incubation is required of all
+newly accepted projects until a further review indicates that the
+infrastructure, communications, and decision making process have
+stabilized in a manner consistent with other successful ASF projects.
+While incubation status is not necessarily a reflection of the
+completeness or stability of the code, it does indicate that the
+project has yet to be fully endorsed by the ASF.
+____
 
-== Podling Constraints
-While in Incubation, Podlings are constrained in the actions they can undertake.
+Podlings wishing to use a different disclaimer message MUST have the
+disclaimer approved by the Incubator PMC prior to use.
 
-=== Branding
-Please consult the guide to link:/guides/branding.html[Podling Branding].
+For releases, the text SHOULD be included in a separate DISCLAIMER file
+stored alongside the NOTICE and LICENSE files.
 
 === Releases
 
@@ -154,103 +85,7 @@ See the guidelines for link:/guides/releasemanagement.html[Podling releases] in
 Should the Incubator PMC, in accordance with these guidelines vote to approve the request, the Podling MAY perform the release under the following constraints:
 
 - the release archive MUST contain the word "incubating" in the filename; and
-- the release archive MUST contain an Incubation disclaimer (as described in the previous section), clearly visible in the main documentation or README file.
+- the release archive MUST contain an Incubation disclaimer (as described in the previous section), which SHOULD be placed in a DISCLAIMER file.
 
 Releases for *podling* MUST be distributed through *++http://www.apache.org/dist/incubator/++_podling_* In addition, the Podling MAY choose to distribute approved releases through other channels like the central Maven repository.
 
-=== Use of Apache Resources
-The Podling is not yet an Apache project, and it should thus always
-refer to the Incubator Project Resource usage Guidelines, that are as
-follows.
-
-=== Website
-Please consult the guide to link:/guides/sites.html[Podling Websites] for the current policies for websites.
-
-== Graduating from the Incubator
-This section describes the requirements and process for graduating from the Incubator.
-
-=== Minimum Graduation Requirements
-Prior to graduation, a Podling needs to show that :
-
-- it is a worthy and healthy project;
-- it truly fits within the ASF framework;and
-- it "gets" the Apache Way.
-
-This is achieved by imposing a set of Graduation Criteria that, when met,
-will demonstrate these objectives.
-
-Therefore, to successfully graduate from the Incubator
-into the ASF, a Podling SHALL meet the minimum requirements
-detailed below. The Incubator PMC MAY set additional requirements at
-their discretion. Such additional requirements MAY be proposed by the
-Mentor or the Sponsor, however only the Incubator PMC is authorised
-to formally place such requirements on a Podling.
-
-The minimum requirements that a Podling SHALL meet prior to being
-graduated to the ASF are :
-
-==== Legal
-- All code AL'ed
-- The code base must contain only ASL or ASL-compatible dependencies
-- License grant complete
-- CLAs on file.
-- Check of project name for trademark issues
-
-==== Meritocracy / Community
-
-- Demonstrate an active and diverse development community
-- The project is not highly dependent on any single contributor (there are at least 3 legally independent committers and there is no single company or entity that is vital to the success of the project)
-- The above implies that new committers are admitted according to ASF practices
-- ASF style voting has been adopted and is standard practice
-- Demonstrate ability to tolerate and resolve conflict within the community.
-- Release plans are developed and executed in public by the community.
-- Engagement by the incubated community with the other ASF communities
-
-==== Votes
-- Incubator PMC has voted for graduation
-- Destination PMC, or ASF Board for a TLP, has voted for final acceptance
-
-==== Alignment / Synergy
-- Use of other ASF subprojects
-- Develop synergistic relationship with other ASF subprojects
-
-==== Infrastructure
-- SVN module has been created
-- Mailing list(s) have been created
-- Mailing lists are being archived
-- Issue tracker has been created
-- Project website has been created and complies with the Apache Project Branding Requirements
-- Project ready to comply with ASF mirroring guidelines
-- Project is integrated with GUMP if appropriate
-- Releases are PGP signed by a member of the community
-- Developers tied into ASF PGP web of trust
-
-=== Termination of a Podling
-If you receive a recommendation for termination then you have a
-problem. Chances are that there are either legal or structural
-problems with your project that in the opinion of the Incubator PMC
-are not resolvable within a reasonable time frame. A termination
-decision is basically time to close down the project. However, you do
-have the right to appeal a termination decision with the Board of
-Directors and/or your Sponsor. You should be aware that several
-Members of the Board are also Members of the Incubator PMC and as
-such, an appeal is unlikely to be successful.
-
-=== Graduation as a Top Level Project
-In cases where a Podling has successfully completed Incubation, and
-is graduating from the Incubator to become a Top Level Project, the Incubator
-PMC SHALL provide a recommendation to the board that the Podling is
-ready to graduate. The recommendation SHALL include a draft
-resolution for the board to vote on.
-
-=== Graduation as a sub-project
-In cases where a Podling has successfully completed Incubation, and
-is graduating from the Incubator to become a sub-project within an already
-existing Top Level Project, the Incubator PMC SHALL provide a
-recommendation to the TLP that the Podling is ready to graduate.
-
-=== Post-Graduation Check List
-See link:/guides/graduation.html[Graduation Guide].
-
-== Roles Defined
-Definitions of the roles involved in the Incubation process can be found on the link:/incubation/Roles_and_Responsibilities.html[Roles and Responsibilities] page.
diff --git a/pages/policy/process.ad b/pages/policy/process.ad
deleted file mode 100644
index f2cde5e..0000000
--- a/pages/policy/process.ad
+++ /dev/null
@@ -1,73 +0,0 @@
-= Incubation Process
-Apache Incubator PMC
-2002-10-16
-:jbake-type: policy
-:jbake-status: published
-:idprefix:
-:toc:
-:imagesdir: ../images/
-
-== Introduction
-This document is an overview of the process. Read it in conjunction with the "Incubation Policy" and the various guides. Also review the Roles and Responsibilities for a description of the various parties involved in the Incubation process.
-
-== The Process of Incubation
-The incubation process covers the establishment of a candidate, acceptance (or rejection) of a candidate leading to the potential establishment of a Podling and associated incubation process, which ultimately leads to the establishment of a new Apache Top-Level-Project (TLP) or sub-project within an existing Apache Project.
-
-image::incubation-process.png[]
-
-== Establishment
-image::howtoincubateaproject.png[]
-The first thing you will want to do is find a Champion for your project. One way to do this is to explore the existing Apache projects to find similar projects. Spend some time reading their project web pages and mailing lists (follow links at each project website). By simply lurking on the project mailing lists (and also the Incubator general list and other Incubating project lists) you may get ideas about who you would like to contact directly to help you with your project proposal.
-
-Simply email that person directly (e.g. username@apache.org, see the committer list to find the username), describe informally yourselves and your project, and ask kindly if she would be willing to act as your Champion for your project within the Apache incubator. Remember that all Apache Committers and Members are volunteers with limited spare time, but you will hopefully find that the person is honoured by your request to be a Champion and sees a potential for your project as a future  [...]
-
-Once you have found an eligible person who is willing to act as Champion, you can use this person to help you determine if and how your proposal can fit within the ASF, and if the "Apache Way" of open development would be right for your project. This might happen over a series of emails, telephone calls or online chat sessions, and should cover any practical concerns such as project infrastructure (e.g. mailing lists, web, source code repositories, issue tracker, wiki) but also the impli [...]
-
-If you and your Champion are convinced that your candidate project would fit with the "Apache Way", your Champion can help you to get it established.
-
-The establishment of a candidate involves the preparation of a Project Proposal (consistent with the candidate description detailed below) endorsed by a Champion.
-
-A Candidate project description should be submitted to the relevant mailing list(s) of a Sponsor. The Sponsor is usually the Incubator (IPMC), (general@incubator.apache.org), assuming your project would aspire to become a top-level project (TLP). In the special case of your project aspiring to become a sub-project of an existing Apache top-level project (e.g. a plugin for Apache OpenOffice), then that project should be your champion and their dev@ mailing list would be where to send the  [...]
-
-Please see:
-
-- a Guide to Proposal Creation
-- existing project proposals for examples
-- Typically a Candidate is submitted under a message tagged with [PROPOSAL]. Such a message will normally trigger some discussions on the receiving mailing list(s). Your Champion will be involved in these discussions acting as your advocate.
-
-As a proposer you should consider the feedback and attempt to gauge a sense of consensus. Do not be put off by extended threads under your initial post that have little or nothing to do with your proposal - however, if you feel that your candidate project is not being addressed, you may want to specifically request a decision on the Candidate by the Sponsor. Sometimes a vote will be announced without you asking for it (perhaps you have done some homework and have a PMC member assisting y [...]
-
-== Acceptance
-The decision to accept a project is taken on a vote by the Sponsor. The format of this vote will depend on the rules of the entity in question. Here again it helps if you have a PMC Member (or board member if the Sponsor is the ASF board) aligned with your project (preferably as your Champion) because you stand a better chance of getting feedback about what is actually happening. The Sponsor will typically take about 7-10 days before announcing a vote result.
-
-If that vote is affirmative, the Sponsor (unless the Sponsor is already the Incubator PMC) will propose to the Incubator PMC(referencing the voting result e-mail) that your candidate project be accepted by the Incubator as a Podling. The Sponsor will assign Mentors. The Mentors may include your original Champion. If not, it is expected your Champion will remain involved during the rest of the Incubation process, providing as much assistance as possible.
-
-The Mentors are there to protect you, but be warned - Mentors are holding a big stick. The Mentors are members of the Incubator PMC, and report to both the PMC and the Sponsor about your overall health and suitability for eventual inclusion within the Apache Community (or recommendation to terminate). However, the Mentors (with the assistance of the Champion) are also looking after you through the incubation.
-
-One of the roles of the Mentors is to keep away the wolves - and in the case of incubation the wolf is the Incubator PMC, the policies, the process, and inevitable bureaucracy and delays. The Mentors can help you by guiding and protecting you from much of this based on their experience in the process and familiarity with the policy and procedures of incubation. In performing their role, the Mentors are representing the Sponsor.
-
-Your Sponsor, represented by your Mentors, has specific responsibilities towards you and the Incubator PMC. There are a bunch of administrative and technical actions to take care of. Your Mentors are responsible for ensuring that these things happen quickly and efficiently. Also, your Mentors are going to help you out with the getting in place of the policies and procedures you use for introducing new comitters, decision making, etc. These aspects will be watched closely by the Incubator [...]
-
-== Review
-As your project sorts things out and things stabilize (infrastructure, communications, decision making) you will inevitably come under an assessment by the Incubator PMC concerning the exit of your project from the incubator. Keep in mind that exit can be a good thing and bad thing. Exit via graduation to a top-level project or perhaps a subproject of an existing PMC would typically be viewed as a positive exit. On the other-hand, termination is also an exit condition that may be conside [...]
-
-Conclusion of a review process will be a recommendation (to the Sponsor) of one of the following:
-
-- termination;
-- continuation under incubation with recommendations; or
-- graduation into Apache.
-
-Note that whilst this is a recommendation, it carries a lot of weight. A Sponsor will only over-ride the recommendation of the Incubator in exceptional circumstances, and even then it is likely that the issue in question would be escalated to the ASF board for their consideration.
-
-== Termination or Retirement
-There are two ways for a project to cease incubation: Termination or Retirement. If you receive a recommendation for termination then you have a problem. Chances are that there are either legal or structural problems with your project that in the opinion of the Incubator PMC are not resolvable within a reasonable time frame. A termination decision is basically time to close down the project. However, you do have the right to appeal a termination decision with the Board of Directors and/o [...]
-
-== Continuation
-A recommendation by the Incubator PMC for continuation of incubation shall include development recommendations. The Incubator PMC has a responsibility to ensure that the recommended actions are tangible and quantifiable. For example, an assessment could be that your project has not established a sufficient community to be viable, in which case the Incubator PMC is obliged to state specific targets that they consider as viable. This does not necessarily mean that if you meet this target b [...]
-
-== Graduation
-For Podlings that aim to establish sub-projects or products within existing communities you are almost home-free. The main issues you need to deal with now is migration of your code into the target project, something you should be confident in doing based on the contacts and understanding you gained during initial establishment and incubation.
-
-For projects aiming to be a Top-Level-Project (TLP), you have an additional obstacle, namely the ASF Board. While the ASF Board might be your Sponsor, this does not mean they have formally accepted you as a TLP. To establish a TLP you need to draft a board motion that identifies the project scope, mission and charter. You can submit the motion to the Board using the board at apache dot org email address. Well-prepared projects will have already developed contacts with members of the Boar [...]
-
-However, in practice, assuming you are building contacts with members in Apache, the Incubator PMC, and the ASF Board, the transition from Podling to TLP should be a smooth and painless process.
\ No newline at end of file


---------------------------------------------------------------------
To unsubscribe, e-mail: cvs-unsubscribe@incubator.apache.org
For additional commands, e-mail: cvs-help@incubator.apache.org