Improvement Plans (PROPOSED / DRAFT)

Table of Contents

1. Policies
2. Guides
3. Workflow
4. Operations
- Column Notes

PROPOSAL / DRAFT / PROPOSAL / DRAFT / PROPOSAL / DRAFT / PROPOSAL / DRAFT / PROPOSAL

This page is for gathering together various improvement plans and prospective implementations for the Incubator. We will gather improvements by category, date, name, JIRA issue, email threads, and coordination required.

1. Policies

Edits to policy documents on the site. Changes to properly follow Foundation policy. Improvements to Incubator Policy. These are changes that will require discussion on general@ and be resolved by Consensus.

Date	Name	JIRA Issue	Email Threads	Notes
03/25/19	Clean Up Retired Podling Repositories	INCUBATOR-233	policy discussion	Infra request. We should define when we should remove a retired repository and then make that change. Same rule needs to apply to distributions and archives.
02/03/15	Clarify whether incubator release announcement should include an incubation disclaimer	INCUBATOR-129		If we want to make this policy then we’ll need to update the press policy and communicate the change.
02/10/07	Define roles and procedures for Incubator PPMC	INCUBATOR-54		Check if there is anything useful to learn from the topic.
07/19/06	Clarify Role of Champion And Consolidate Policy	INCUBATOR-33		There has been some discussion around this role and it might be worth focusing on this in the future.
01/07/06	Incubation_Policy.html should specify to use the Incubator PMC	INCUBATOR-10		This is about the Sponsor role. It will be worth discussing in the future the best way to rewrite the Sponsor role.

03/25/19

Clean Up Retired Podling Repositories

INCUBATOR-233

policy discussion

Infra request. We should define when we should remove a retired repository and then make that change. Same rule needs to apply to distributions and archives.

02/03/15

Clarify whether incubator release announcement should include an incubation disclaimer

INCUBATOR-129

If we want to make this policy then we’ll need to update the press policy and communicate the change.

02/10/07

Define roles and procedures for Incubator PPMC

INCUBATOR-54

Check if there is anything useful to learn from the topic.

07/19/06

Clarify Role of Champion And Consolidate Policy

INCUBATOR-33

There has been some discussion around this role and it might be worth focusing on this in the future.

01/07/06

Incubation_Policy.html should specify to use the Incubator PMC

INCUBATOR-10

This is about the Sponsor role. It will be worth discussing in the future the best way to rewrite the Sponsor role.

2. Guides

Guides that are missing. Guidance that is unclear. Leave a clear trail and we can review the completed change.

Date	Name	JIRA Issue	Email Threads	Notes
03/27/19	Incubator Cookbook	INCUBATOR-234	Thread 03/26	This effort is to rewrite the Incubator site as a friendly cookbook.
11/17/17	Transferring guide needs an editing pass	INCUBATOR-208
06/26/17	Graduation steps guide enhancements	INCUBATOR-202		Discuss instructions with Infra
05/27/13	Sometimes its not clear that the who vets the podling name	INCUBATOR-126		Make only clarifying adjustments so it is clear that the podling does the search.
04/07/12	Instructions for updating main Incubator site post-graduation	INCUBATOR-124		Discuss instructions with Infra
11/18/07	Communication Guide	INCUBATOR-70		Some of these ideas are outdated, but some of these might be useful community building advice.

03/27/19

Incubator Cookbook

INCUBATOR-234

Thread 03/26

This effort is to rewrite the Incubator site as a friendly cookbook.

11/17/17

Transferring guide needs an editing pass

INCUBATOR-208

06/26/17

Graduation steps guide enhancements

INCUBATOR-202

Discuss instructions with Infra

05/27/13

Sometimes its not clear that the who vets the podling name

INCUBATOR-126

Make only clarifying adjustments so it is clear that the podling does the search.

04/07/12

Instructions for updating main Incubator site post-graduation

INCUBATOR-124

Discuss instructions with Infra

11/18/07

Communication Guide

INCUBATOR-70

Some of these ideas are outdated, but some of these might be useful community building advice.

3. Workflow

This category is for more structural improvements like changing the build and updating IP record keeping.

Date	Name	JIRA Issue	Email Threads	Notes
03/05/19	Cleanup Git-generated Incubator website	INCUBATOR-231	Clutch2 Announce	We now have new projects and clutch pages. The podling status pages are still in the old style. There are some open questions about the yml content that is managed from the podling roster page.
05/22/17	Extend podlings.xml to include old names and TLP parent	INCUBATOR-199		This is a proxy issue. The topic here is to improve the maintenance of our podling roster. I think we should work with the Whimsy PMC to improve maintenance of the podling roster.
04/23/08	IP Clearance Template is rubbish	INCUBATOR-74		This is meant to be provocative. I think we can work with the Whimsy PMC to improve how we keep and manage IP Clearances for TLPs.

03/05/19

Cleanup Git-generated Incubator website

INCUBATOR-231

Clutch2 Announce

We now have new projects and clutch pages. The podling status pages are still in the old style. There are some open questions about the yml content that is managed from the podling roster page.

05/22/17

Extend podlings.xml to include old names and TLP parent

INCUBATOR-199

This is a proxy issue. The topic here is to improve the maintenance of our podling roster. I think we should work with the Whimsy PMC to improve maintenance of the podling roster.

04/23/08

IP Clearance Template is rubbish

INCUBATOR-74

This is meant to be provocative. I think we can work with the Whimsy PMC to improve how we keep and manage IP Clearances for TLPs.

4. Operations

This category is for cosmetic improvements, minor issues, and operational issues.

Date	Name	JIRA Issue	Email Threads	Notes
06/18/18	Incorrect bounce message for retired podling mailing lists	INFRA-18132		For example the link should be https://incubator.apache.org/projects/#slider - moved the issue to INFRA.
09/16/16	Missing archiver/archives for dev@incubator - is it needed?	INCUBATOR-201	Thread 03/25/19	Once we agree to remove these accidental mailing lists work with Infra.
04/04/17	clean up archive.a.o	INCUBATOR-198		Once we decide which retired podlings need cleanup then apply the same with the archive. Work with Infra if necessary.

06/18/18

Incorrect bounce message for retired podling mailing lists

INFRA-18132

For example the link should be https://incubator.apache.org/projects/#slider - moved the issue to INFRA.

09/16/16

Missing archiver/archives for dev@incubator - is it needed?

INCUBATOR-201

Thread 03/25/19

Once we agree to remove these accidental mailing lists work with Infra.

04/04/17

clean up archive.a.o

INCUBATOR-198

Once we decide which retired podlings need cleanup then apply the same with the archive. Work with Infra if necessary.

Column Notes

Date

The date the JIRA issue was created or a thread was started about the improvement.

Name

A descriptive name for the improvement. Should be similar to the original subject whether JIRA or Email.

JIRA Issue

A link to the JIRA issue. https\://issues.apache.org/jira/projects/INCUBATOR/issues/INCUBATOR-231[INCUBATOR-231]

Email Threads

Permalinks to discussions. Please use lists.apache.org. Don’t use nabble or gmane, we have guarantees about apache.org uris and none about third parties. There are a number of ten or more year old discussions that will be difficult to single out due to gmane changes.

Topic Notes

Questions for the team. Information about the change. There may be dependencies. Some changes will require working with others in the organization including INFRA, Whimsy, Legal, …