Differences between revisions 10 and 11
Revision 10 as of 2009-05-14 17:36:20
Size: 8706
Editor: DavidGoodger
Comment:
Revision 11 as of 2009-05-17 18:56:28
Size: 10920
Editor: DavidGoodger
Comment:
Deletions are marked like this. Additions are marked like this.
Line 11: Line 11:
Copy 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 21: Line 24:

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.
Line 141: Line 166:
   a. 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.

   b. 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.)

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

    Originally from DD Month YYYY,

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

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

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

      (XXX split?)
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.
Line 170: Line 193:
9. g. "New on ..." subsection: update the date of the last month's
      meeting in the title and the first paragraph.

   h. 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:

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

      For each new action item, after the item number in brackets,
      add
the word "Section", the section number, a comma (","), the
1. Update the date of the last month's meeting in the title and the
   first paragraph
.

2. Collect all the n
ew 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
Line 189: Line 216:
      Look up section numbers on the web (table of contents of the web page of last month's minutes).

     
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.).

      Move the edited action
     
item into a numbered list in the "New on ..." section.

      XXX
Delete as you go.
      * 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.
Line 203: Line 238:
Look at the `action items wiki page`_. Any action items added since the
last Board meeting should be recorded in the minutes.

Line 206: Line 245:
10. Referring to the `"Action Items" private wiki page`_, update the action items:

    * For all action items done or dropped, add brief details (link,
      date, etc., if applicable). Remove the action item markup:
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 213: Line 252:
    Add one of the following status lines::    Add one of the following status lines::
Line 219: 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 229: Line 268:
      Do not use bold-face markup ("**") for the status of non-final
      items.

11. and the
    meeting transcript (IRC log)
   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).
Line 242: Line 283:
* check the agenda,

* scan the log for new business,

* make a new section title for each item of business or discussion,
  (underline with "====")

* summarize the discussion

  - use quotes where appropriate: "" vs block quotes, [edited], "...",
  - omit sensitive information and disagreements
  - summarize the consensus

* copy & paste resolutions from the log, correct misspellings & grammar
  & sentence structure, etc.

  Format::
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::
Line 264: Line 328:
* usually include an action item. Sometimes the action item is left implicit.

1. Note action items as follows::
5. Usually include an explicit action item.
 
Sometimes the action item is left implicit in the discussion.

  Note action items as follows::
Line 270: Line 335:
  Use initial

  If there are multiple action items in a section, number them in a
    list::
   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::
Line 279: Line 344:
  (List items need not be adjacent. They may be separated by
    explanatory paragraphs etc.)
   (List items need not be adjacent. They may be separated by
   explanatory paragraphs etc.)
Line 286: Line 351:
Update the `"Action Items" private wiki page`_ with new action items
and status updates.


Inform the Board
================

Send a copy of the completed minutes to the Board mailing list
(psf@python.org).
Edit the `Action Items wiki page`_.

1. Add new action items and status updates.

   - Note the date of the meeting in YYYY-MM-DD format.
   - Note the section number, prefixed with the "§" symbol.

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


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

1. Send a copy of the completed minutes to the PSF Secretary for approval.

2. Once approved, send a copy to the Board mailing list (psf@python.org).
Line 300: Line 372:
* List of PSF Board meeting minutes (with links): * _`List of PSF Board meeting minutes` (with links):
Line 316: Line 388:

* `"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.

  1. Add new action items and status updates.

    • Note the date of the meeting in YYYY-MM-DD format.
    • Note the section number, prefixed with the "§" symbol.
  2. Transfer the action item numbers from the wiki page back to the minutes.

6   Inform the Secretary and the Board

  1. Send a copy of the completed minutes to the PSF Secretary for approval.
  2. Once approved, send a copy 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.