Differences between revisions 1 and 16 (spanning 15 versions)
Revision 1 as of 2009-01-06 03:12:30
Size: 4965
Editor: DavidGoodger
Comment:
Revision 16 as of 2009-05-18 15:46:44
Size: 12242
Editor: DavidGoodger
Comment:
Deletions are marked like this. Additions are marked like this.
Line 11: Line 11:
Copy & Update Last Month's Minutes
==================================

1. Make a copy of the last month's minutes
   (build/data/psf/records/board/minutes/YYYY-MM-DD/content.ht in the
   `website repository`_)
.
Preparation
===========

You will need:

1. A copy of last month's minutes.

   In the `website repository`_:
   
build/data/psf/records/board/minutes/YYYY-MM-DD/content.ht.
Line 22: Line 25:
2. Update last month's minutes, removing "(Draft)" from the first line
   and "| Draft" from the title block.

3. Update the table of contents,
   build/data/psf/records/board/minutes/content.ht. At the top, add a
2. The `Board agenda wiki page`_ **for this month's meeting**
   [#wiki-history]_.

   .. _Board agenda wiki page: http://wiki.python.org/psf/BoardAgenda

3. The `action items wiki page`_ **as of this month's meeting**
   [#wiki-history]_.

   .. _action items wiki page: http://wiki.python.org/psf/Action_Items

.. [#wiki-history] The wiki page may have changed since the meeting.
   You should use the version of the wiki page *as it was** as of the
   beginning of the Board meeting.

   1. Use the "Info" link near the top of the page to see the revision
      history of the wiki page.

   2. In the "Date" column, find the date closest to (but before) the
      beginning of the Board meeting.

   3. In that row, click the "View" link in the "Action" (last) column.


Update Last Month's Minutes
==================================

If the minutes of last month's meeting were approved,
update last month's minutes:

1. Remove "(Draft)" from the first ("Title:") line.

2. Remove "| Draft" from the title block.


Update the List of Meeting Minutes
==================================

The list of meeting minutes (table of contents) is at
build/data/psf/records/board/minutes/content.ht in the
`website repository`_.

1. Add a header for the new year in January.

2. At the top of the list, add a
Line 30: Line 72:

   Add a header for the new year in January.
Line 37: Line 77:
1. Update the date in the page title (first line) and in the title
   block ("|" border on the left). Be sure the title line says
   "(Draft)" and the title block has "| Draft" under the date.

2. Update the date & time in the intro paragraph under the title
   block. Verify who presided and who prepared the minutes.

3. Update the "Attendance" section, both Directors and "Also in
   attendance". If someone came late, after a vote, note the time
   they arrived (e.g. "(arrived at 17:20)"). Also note if anyone left
   early.

4. Update the "Minutes of Past Meetings" section. Update the date of
   last month's meeting, and the vote. If there were any special
Title
-----

1. Update the date in the page title (first line).
   Be sure the title line says "(Draft)" at the end.

2. Update the date in in the title block ("|" border on the left).
   Be sure the title block has "| Draft" under the date.


Intro Paragraph
---------------

1. Update the date & time (in the UTC/GMT time zone) in the intro
   paragraph under the title block. Use the `World Clock
   <http://www.timeanddate.com/worldclock/>`_ to get the current
   time UTC time.

2. Verify who presided and who prepared the minutes, and correct
   if necessary.


Attendance
----------

1. Update the list of attendees, both Directors and "Also in
   attendance". Directors names should be listed in alphabetical
   order by family name.

   If someone came late, after a vote, note the time
   they arrived (e.g. "(arrived at 17:20)").
   Also note if anyone left early.
   Always use the UTC timezone.


Minutes of Past Meetings
------------------------

Update the "Minutes of Past Meetings" section.

1. Update the date of last month's meeting, and the vote.

2. If there were any special
Line 55: Line 124:
5. Update the "Actions Taken Since the Last Meeting" section with any
   resolutions or major actions taken between minuted meetings. If
   there were none, replace "The actions below" with "No actions".
   Each action should be in its own subsection (underline with
   hyphens, i.e. "----").

6. Update the "Status of Past Action Items" section.

   a. "Carried Forward" subsection: update the date of the last
      month's meeting. Verify the section number.

      Remove any items marked ``**done**`` or ``**dropped**`` in the
      last month's minutes.

      For items not marked ``**done**`` or ``**dropped**`` in last
      month's "New from _____" subsection, move them into the "Carried
      Forward" subsection. Add the following as a prefix:

          Originally from DD Month YYYY,

      Renumber the list from 1, adjusting indentation as necessary.

   b. "New from _____" subsection: update the date of the last month's
      meeting in the title and the first paragraph. Copy all action
      items from last month's minutes into a numbered list, and insert
      the section number and title ("Section X, Title:"). If there
      was more than one action item in a section (should be numbered),
      join the section number and the item number with a "." ("X.Y").

   Referring to the `"Action Items" private wiki page`_ and the
   meeting transcript (IRC log), update the action items:

   * For all action items done or dropped, add brief details (link,
     date, etc., if applicable). Remove the action item markup:
3. Remove any unnecessary approvals.


Votes Taken Between Meetings
----------------------------

Update the "Votes Taken Between Meetings" section.

1. Update the date of last month's meeting.

2. If there were some votes on resolutions, write the following::

       The actions below were taken since the <D Month YYYY> meeting.

3. If there were no resolutions, write the following::

       No votes were taken since the <D Month YYYY> Board meeting.

4. Add any resolutions voted upon between minuted meetings.
   Each action should be in its own subsection.
   Example::

       Title of Resolution
       -------------------

           **RESOLVED**, that ...

       Approved by unanimous email vote, <D Month YYYY>.

   If anyone abstained from voting, note that too: "(X abstentions)".


Status of Past Action Items
---------------------------

Update the "Status of Past Action Items" section.

Carried Forward
'''''''''''''''

Update the "Carried Forward" subsection:

1. In the first paragraph,
   update the date of the last month's meeting.
   Verify the section number of last month's "Status of Past
   Action Items" section.

2. Remove any items marked ``**done**`` or ``**dropped**`` in the
   last month's minutes. (Scan for "``Status: **done**``" and
   "``Status: **dropped**``" in the copied minutes, and remove any
   such items.)

3. In last month's "New ..." subsections: add the following as
   a prefix to each item:

       Originally from DD Month YYYY,

4. Move all items from the "New ..." subsections into the "Carried
   Forward" subsection, at the bottom.

5. Remove all old notes from action items (text below the action
   item and above the "Status" line).

6. Renumber the list from 1, adjusting indentation as necessary.


New on <D Month YYYY>
'''''''''''''''''''''

1. Update the date of the last month's meeting in the title and the
   first paragraph.

2. Collect all the new action items in last month's minutes, and put
   them into a numbered list in the "New on <date of last meeting>"
   section:

   1. Scan the "new business" sections (all the sections after "Status
      of Past Action Items") in last month's minutes, and locate new
      action items.

   2. For each new action item, after the item number in brackets, add
      the word "Section", the section number, a comma (","), the
      section title, and a colon (":").

      For example::

          [0] :action:`J. Doe ...`

      becomes::

          [0] Section 5, Example Section: :action:`J. Doe ...`

      * Look up section numbers on the web: see `list of PSF Board
        meeting minutes. The table of contents of the web page of
        last month's minutes lists the section numbers.

      * If there was more than one action item in a section (they
        should be numbered), join the section number and the item
        number with a "." (e.g. "5.1", "5.2", etc.).

3. Move the edited action item into a numbered list in the "New on
   ..." section. Numbered lists look like this::

       1. item one...

       2. item two...

4. Delete the unused portions of the copied text of last month's
   minutes as you go.


New Between Meetings
''''''''''''''''''''

Look at the `action items wiki page`_. Any action items added since the
last Board meeting should be recorded in the minutes.


Update the Action Items
'''''''''''''''''''''''

Referring to the `action items wiki page`_, update the action items:

1. For all action items done or dropped, add brief details (link,
   date, etc., if applicable). Remove the action item markup:
Line 92: Line 252:
   Add one of the following status lines::    Add one of the following status lines::
Line 98: Line 258:
   Bold-face markup ("**") is only used for the status of finalized
     items (items that will be removed next month).

   * For other action items, add brief details and add (or adjust) the
   status lines as follows::
   Bold-face markup ("**") is only used for the status of finalized
   items (items that will be removed next month).

2. For other action items, add brief details and add (or adjust) the
   status lines as follows::
Line 108: Line 268:
     Do not use bold-face markup ("**") for the status of non-final
     items.

7. Referring to the meeting agenda and transcript (IRC log), add a
   section for each topic discussed. Note action items as follows::

       :action:`J. Doe will do XYZ.`
   Do not use bold-face markup ("**") for the status of non-final
   items.

While summarizing new business from the meeting transcript (IRC log),
record any updates to existing action items as above, and on the
`action items wiki page`_. If there is more than a brief status update
note, create a new section (as in `Add Sections for New Business`_ below).


Add Sections for New Business
-----------------------------

Referring to the meeting agenda and transcript (IRC log), add a
section for each topic discussed.

1. Scan the log for new business. The log should roughly correspond
   to the agenda, but will diverge.

2. Create a new section title for each item of business or discussion::

      Section Title
      =============

   For the title text, check the agenda. Title text should be brief
   and to the point.

3. Summarize the discussion.

   - Use direct quotes where appropriate. For brief quotes:

         J. Doe: "What he said."

     For extended passages, use block quotes:

         J. Doe:

             vs block quotes,

     When editing to clarify, use square brackets ("[" & "]") around
     text that was not actually written by the person quoted.

     When omitting segments, use ellipses ("...") to indicate omitted text.
 
  - Paraphrase what was said: "The Board agreed that ...", "J. Doe noted
    that ...", "J. Doe reported ...", "The Board decided ...", etc.

  - Omit sensitive information and disagreements.

  - Summarize the consensus.

4. Copy & paste resolutions from the log.

   Correct misspellings, grammar, and sentence structure, etc.

   Format::

          **RESOLVED**, that ...

      Approved, 8-0-0.

5. Usually include an explicit action item.
   Sometimes the action item is left implicit in the discussion.

   Note action items as follows::

       [] :action:`J. Doe will do XYZ.`

   Use the initial of the given name, and the full family name.
Line 126: Line 347:
Send a copy of the completed minutes to the Board mailing list
(psf@python.org).


Update Action Items
===================

Update the `"Action Items" private wiki page`_ with new action items
and status updates.

Update Action Items Wiki Page
=============================

Edit the `Action Items wiki page`_.

Scan the minutes of this month's Board meeting for new action items
and updates to existing action items.


Add status updates to existing action items
-------------------------------------------

1. Add brief status text to the "Description" column.

2. Update the "Status" column if applicable.

3. Update the "On" date.


Add new action items
--------------------

Add new action items to the "Outstanding Items" section of the wiki page.

1. Duplicate the text of the last row of the table.
   Select the last row, copy the text, and paste so that there
   are two copies of that row.
   The second-last row will be the new action item.

2. Transfer the action item number from the wiki page back to the minutes.

3. Increment the ID on the last row (the placeholder for the "Next" action item).

4. In the "Who" column (column 2), note the initials of the person
   or people responsible for the action item.

5. In the "Since" column (column 3):

   a. Note the date of the meeting in YYYY-MM-DD format.
   b. Also note the section number from the minutes,
      prefixed with the "§" symbol.
      (The first new business section will be section 5.)

6. In the "Description" column, remove the old instructional text ("Next ...").
   Add the text of the action item (not including the markup:
   "``:action:```" & "`````").

7. In the "Status" column, type "Pending".

8. In the "On" column, add the date of the meeting (YYYY-MM-DD).


Inform the Secretary and the Board
==================================

1. Send a copy of the completed minutes to the PSF Secretary for approval
   (markup fixes, content, etc.).

2. Send a copy of the minutes (as edited and approved by the Secretary)
   to the Board mailing list (psf@python.org).
Line 140: Line 413:
* _`List of PSF Board meeting minutes` (with links):
  http://www.python.org/psf/records/board/minutes/

Line 142: Line 419:

  Board meeting minutes:
  https://svn.python.org/www/trunk/beta.python.org/build/data/psf/records/board/minutes/

  Members' meeting minutes:
  https://svn.python.org/www/trunk/beta.python.org/build/data/psf/records/members/
Line 146: Line 429:

* `"Action Items" private wiki page
  <http://wiki.python.org/psf/Action_Items>`_

How To Prepare the Board Meeting Minutes

1   Preparation

You will need:

  1. A copy of last month's minutes.

    In the website repository: build/data/psf/records/board/minutes/YYYY-MM-DD/content.ht.

    E.g. copy build/data/psf/records/board/minutes/2008-11-10/content.ht to build/data/psf/records/board/minutes/2008-12-08/content.ht

  2. The Board agenda wiki page for this month's meeting [1].
  3. The action items wiki page as of this month's meeting [1].
[1](1, 2)

The wiki page may have changed since the meeting. You should use the version of the wiki page as it was* as of the beginning of the Board meeting.

  1. Use the "Info" link near the top of the page to see the revision history of the wiki page.
  2. In the "Date" column, find the date closest to (but before) the beginning of the Board meeting.
  3. In that row, click the "View" link in the "Action" (last) column.

2   Update Last Month's Minutes

If the minutes of last month's meeting were approved, update last month's minutes:

  1. Remove "(Draft)" from the first ("Title:") line.
  2. Remove "| Draft" from the title block.

3   Update the List of Meeting Minutes

The list of meeting minutes (table of contents) is at build/data/psf/records/board/minutes/content.ht in the website repository.

  1. Add a header for the new year in January.
  2. At the top of the list, add a link to the now-approved last month's minutes, e.g.:

    * `November 10, 2008 <2008-11-10>`_

4   Update This Month's Minutes

4.1   Title

  1. Update the date in the page title (first line). Be sure the title line says "(Draft)" at the end.
  2. Update the date in in the title block ("|" border on the left). Be sure the title block has "| Draft" under the date.

4.2   Intro Paragraph

  1. Update the date & time (in the UTC/GMT time zone) in the intro paragraph under the title block. Use the World Clock to get the current time UTC time.
  2. Verify who presided and who prepared the minutes, and correct if necessary.

4.3   Attendance

  1. Update the list of attendees, both Directors and "Also in attendance". Directors names should be listed in alphabetical order by family name.

    If someone came late, after a vote, note the time they arrived (e.g. "(arrived at 17:20)"). Also note if anyone left early. Always use the UTC timezone.

4.4   Minutes of Past Meetings

Update the "Minutes of Past Meetings" section.

  1. Update the date of last month's meeting, and the vote.
  2. If there were any special meetings, note them and their votes also (e.g. annual Members' Meeting and first meeting of the new Board of Directors are both held at PyCon).
  3. Remove any unnecessary approvals.

4.5   Votes Taken Between Meetings

Update the "Votes Taken Between Meetings" section.

  1. Update the date of last month's meeting.
  2. If there were some votes on resolutions, write the following:

    The actions below were taken since the <D Month YYYY> meeting.
  3. If there were no resolutions, write the following:

    No votes were taken since the <D Month YYYY> Board meeting.
  4. Add any resolutions voted upon between minuted meetings. Each action should be in its own subsection. Example:

    Title of Resolution
    -------------------
    
        **RESOLVED**, that ...
    
    Approved by unanimous email vote, <D Month YYYY>.

    If anyone abstained from voting, note that too: "(X abstentions)".

4.6   Status of Past Action Items

Update the "Status of Past Action Items" section.

4.6.1   Carried Forward

Update the "Carried Forward" subsection:

  1. In the first paragraph, update the date of the last month's meeting. Verify the section number of last month's "Status of Past Action Items" section.
  2. Remove any items marked **done** or **dropped** in the last month's minutes. (Scan for "Status: **done**" and "Status: **dropped**" in the copied minutes, and remove any such items.)
  3. In last month's "New ..." subsections: add the following as a prefix to each item:

    Originally from DD Month YYYY,
  4. Move all items from the "New ..." subsections into the "Carried Forward" subsection, at the bottom.
  5. Remove all old notes from action items (text below the action item and above the "Status" line).
  6. Renumber the list from 1, adjusting indentation as necessary.
4.6.2   New on <D Month YYYY>
  1. Update the date of the last month's meeting in the title and the first paragraph.
  2. Collect all the new action items in last month's minutes, and put them into a numbered list in the "New on <date of last meeting>" section:

    1. Scan the "new business" sections (all the sections after "Status of Past Action Items") in last month's minutes, and locate new action items.
    2. For each new action item, after the item number in brackets, add the word "Section", the section number, a comma (","), the section title, and a colon (":").

      For example:

      [0] :action:`J. Doe ...`

      becomes:

      [0] Section 5, Example Section: :action:`J. Doe ...`
      • Look up section numbers on the web: see `list of PSF Board meeting minutes. The table of contents of the web page of last month's minutes lists the section numbers.

        System Message: WARNING/2 (<string>, line 215); backlink

        Inline interpreted text or phrase reference start-string without end-string.

      • If there was more than one action item in a section (they should be numbered), join the section number and the item number with a "." (e.g. "5.1", "5.2", etc.).

  3. Move the edited action item into a numbered list in the "New on ..." section. Numbered lists look like this:

    1. item one...
    
    2. item two...
  4. Delete the unused portions of the copied text of last month's minutes as you go.
4.6.3   New Between Meetings

Look at the action items wiki page. Any action items added since the last Board meeting should be recorded in the minutes.

4.6.4   Update the Action Items

Referring to the action items wiki page, update the action items:

  1. For all action items done or dropped, add brief details (link, date, etc., if applicable). Remove the action item markup:

    :action:` & `

    Add one of the following status lines:

    Status: **done**.
    
    Status: **dropped**.

    Bold-face markup ("**") is only used for the status of finalized items (items that will be removed next month).

  2. For other action items, add brief details and add (or adjust) the status lines as follows:

    Status: carried forward.
    
    Status: in progress.

    Do not use bold-face markup ("**") for the status of non-final items.

While summarizing new business from the meeting transcript (IRC log), record any updates to existing action items as above, and on the action items wiki page. If there is more than a brief status update note, create a new section (as in Add Sections for New Business below).

4.7   Add Sections for New Business

Referring to the meeting agenda and transcript (IRC log), add a section for each topic discussed.

  1. Scan the log for new business. The log should roughly correspond to the agenda, but will diverge.
  2. Create a new section title for each item of business or discussion:

    Section Title
    =============

    For the title text, check the agenda. Title text should be brief and to the point.

  3. Summarize the discussion.

    • Use direct quotes where appropriate. For brief quotes:

      1. Doe: "What he said."

      For extended passages, use block quotes:

      1. Doe:

        vs block quotes,

      When editing to clarify, use square brackets ("[" & "]") around text that was not actually written by the person quoted.

      When omitting segments, use ellipses ("...") to indicate omitted text.

  • Paraphrase what was said: "The Board agreed that ...", "J. Doe noted that ...", "J. Doe reported ...", "The Board decided ...", etc.
  • Omit sensitive information and disagreements.
  • Summarize the consensus.
  1. Copy & paste resolutions from the log.

    Correct misspellings, grammar, and sentence structure, etc.

    Format:

        **RESOLVED**, that ...
    
    Approved, 8-0-0.
  2. Usually include an explicit action item. Sometimes the action item is left implicit in the discussion.

    Note action items as follows:

    [] :action:`J. Doe will do XYZ.`

    Use the initial of the given name, and the full family name.

    If there are multiple action items in a section, number them in a list:

    1. :action:`J. Doe will do XYZ.`
    
    2. :action:`A. Square will do ABC.`

    (List items need not be adjacent. They may be separated by explanatory paragraphs etc.)

5   Update Action Items Wiki Page

Edit the Action Items wiki page.

Scan the minutes of this month's Board meeting for new action items and updates to existing action items.

5.1   Add status updates to existing action items

  1. Add brief status text to the "Description" column.
  2. Update the "Status" column if applicable.
  3. Update the "On" date.

5.2   Add new action items

Add new action items to the "Outstanding Items" section of the wiki page.

  1. Duplicate the text of the last row of the table. Select the last row, copy the text, and paste so that there are two copies of that row. The second-last row will be the new action item.
  2. Transfer the action item number from the wiki page back to the minutes.
  3. Increment the ID on the last row (the placeholder for the "Next" action item).
  4. In the "Who" column (column 2), note the initials of the person or people responsible for the action item.
  5. In the "Since" column (column 3):

    1. Note the date of the meeting in YYYY-MM-DD format.
    2. Also note the section number from the minutes, prefixed with the "§" symbol. (The first new business section will be section 5.)
  6. In the "Description" column, remove the old instructional text ("Next ..."). Add the text of the action item (not including the markup: ":action:`" & "`").
  7. In the "Status" column, type "Pending".
  8. In the "On" column, add the date of the meeting (YYYY-MM-DD).

6   Inform the Secretary and the Board

  1. Send a copy of the completed minutes to the PSF Secretary for approval (markup fixes, content, etc.).
  2. Send a copy of the minutes (as edited and approved by the Secretary) to the Board mailing list (psf@python.org).

howto/Board Minutes (last edited 2009-05-20 13:33:52 by DavidGoodger)

Unable to view page? See the FrontPage for instructions.