Rewriting how we onboard PMC chairs to:
- 1)Make the process friendlier and easier for new chairs
- 2)Make the to-dos and other chair-specific advice visible (instead of hidden in a private .txt file)
- Other ideas: writing an automated Whimsy form that updates affiliations.txt for you
- Other ideas: update /dev/pmc.html sections to be clearer, as well as any incubator documentation for how to choose a chair.
1) Proposed New Onboarding Email Text
This will replace https://github.com/apache/whimsy/blob/master/www/board/agenda/views/actions/todos.json.rb#L199
Dear newly-appointed PMC Chair(s),
Congratulations on being appointed by the board as a project VP and Chair of your PMC! Please read the following list of required to-dos for new Chairs, which includes key links to all the duties and responsibilities of being a Chair:
https://apache.org/dev/pmc-chair.html
Now's a great time to thank the outgoing PMC Chair too, if there is one.
Thanks for volunteering!
- (signature for secretary)
2) Proposed New Chair Todos Webpage
This will be a new page at a.o/dev/pmc-chair.html and would replace foundation/officers/advice-for-new-pmc-chairs.txt
Congratulations on being appointed by the board as a project VP and Chair of your PMC, and thanks for volunteering to be a PMC Chair and help represent your project to the Board! The ASF relies on volunteers like you to help the Board provide the required oversight for our many projects.
Please run through the following checklist now to take action to accept your role, and read on for details about all the duties and responsibilities of a PMC Chair.
PMC Chair First Steps - Required
- Update the affiliations.txt (link/instructions below TBD) file with your new ASF role and any personal affiliations. This is required for ASF corporate filings.
- Chairs are responsible for ensuring quarterly reports to the board are submitted. While any PMC members may help, the Board holds the chair responsible for ensuring reports get filed.
- Review the Reporting Guidelines so you understand what should be in your project reports.
- Consider using the Board Reporter Wizard tool, which helps you draft and submit reports.
- Chairs are responsible for sharing any Board feedback with your PMC, and ensuring any Board questions for your are answered.
- Chairs may subscribe to the privately-archived board@ mailing list, if desired; reading board@ sometimes helps provide perspective on how the Board interacts with all ASF projects.
- If your project graduated from the Incubator, be sure to complete the graduation handoff steps.
- Also recall that newly graduated projects must report monthly for the first three months.
Other PMC Chair Responsibilities And Tips
- Read the complete guide on duties of a PMC Chair.
- While any PMC member can handle some PMC updates, in some cases only the Chair may have permissions to make roster updates.
- PMC Chairs are Vice Presidents / officers of the ASF, although you will rarely use the title.
- Chairs may attend monthly Board meetings, and many Chairs have found it useful to see how Board meetings work.
- You may want to review these private repositories for more information about the Board, reporting, and PMC governance. These directories are private to ASF officers and ASF Members only, so do not share this information elsewhere. You can use Subversion to checkout the directories below, or simply use your browser to login with your ASF credentials and view files.
- https://svn.apache.org/repos/private/foundation/officers - data files and some tools about ICLAs and other records.
- https://svn.apache.org/repos/private/foundation/board - current and past Board meeting agenda files (see also: Board Minutes).
- https://svn.apache.org/repos/private/committers/board - official board calendar and PMC committee-info.txt listings.
- If your project website lists PMC members, be sure to update your name as the Chair.
- This is also a great time to thank the outgoing PMC Chair for their work!
How To Update affiliations.txt
All newly appointed officers or directors need to update the affiliations.txt file by adding one line about themselves to the end of the file, following the format defined in the top of the text file. If you've checked out the foundation/officers repository, simply edit and checkin the file there. If you still need to checkout the directory to edit, you can do this:
svn checkout https://svn.apache.org/repos/private/foundation/officers --depth files
cd officers
(edit affiliations.txt to add your line)svn commit affiliations.txt -m "Add my affiliations for new PMC role"
FYI: How PMC Chairs Get Chosen
(either) PPMC chooses a chair for their proposed TLP: https://incubator.apache.org/guides/graduation.html#preparing_a_charter, points to committers/board/templates/
(or) Existing PMC votes/consensus/chooses a new chair: https://apache.org/dev/pmc.html#newchair, points to whimsy board agenda 'add item'
(then) Board passes resolution
(then) Secretary sends out "Welcome new officers" email
FYI: New Chair Todos
Read /dev/pmc.html#chair
Read advice-for-new-pmc-chairs.txt
- board reports
- process of new committers/pmc chairs
- board meeting attend
- board@ subscription / be aware
- Checkout repos: f/officers, f/board, c/board
- Update affiliations.txt
- ? update FOAF?
- Incubator graduation tasks if needed
- project website update if PMC chair named
- See overall duties dev/pmc.html#chair