Fix up README.rst

Change-Id: I43e525f89d599425116cdece2d708666049b7408
This commit is contained in:
Lance Bragstad 2014-10-05 16:40:25 +00:00
parent 3c37a92bd8
commit e3a6bf31d7
1 changed files with 57 additions and 46 deletions

View File

@ -27,69 +27,75 @@ directory. This directory already contains YAML files for the meetings
found on the `Meetings <https://wiki.openstack.org/wiki/Meetings>`_ wiki page.
To create a new meeting YAML file, read the `YAML Meeting File` section below.
::
$ python convert.py -h
usage: convert.py [-h] -y YAML_DIR -i ICAL_DIR [-f]
::
A tool that automates the process for testing, integrating, and
publishing changes to OpenStack meetings using the existing OpenStack
project infrastructure.
$ python convert.py -h
usage: convert.py [-h] -y YAML_DIR -i ICAL_DIR [-f]
optional arguments:
-h, --help show this help message and exit
-y YAML_DIR, --yamldir YAML_DIR
directory containing YAML to process
-i ICAL_DIR, --icaldir ICAL_DIR
directory to store converted iCal
-f, --force forcefully remove old .ics files from iCal directory
A tool that automates the process for testing, integrating, and
publishing changes to OpenStack meetings using the existing OpenStack
project infrastructure.
::
$ git clone https://github.com/openstack-infra/gerrit-powered-agenda.git
$ cd /opt/stack/gerrit-powered-agenda/arbiter/
optional arguments:
-h, --help show this help message and exit
-y YAML_DIR, --yamldir YAML_DIR
directory containing YAML to process
-i ICAL_DIR, --icaldir ICAL_DIR
directory to store converted iCal
-f, --force forcefully remove old .ics files from iCal
directory
::
$ git clone https://github.com/openstack-infra/gerrit-powered-agenda.git
$ cd /opt/stack/gerrit-powered-agenda/arbiter/
The following are a few scenarios:
Generate .ics files locally from existing yaml meeting files:
::
$ python convert.py -y /opt/stack/gerrit-powered-agenda/meetings/ \
-i /opt/stack/gerrit-powered-agenda/icals/
::
$ python convert.py -y /opt/stack/gerrit-powered-agenda/meetings/ \
-i /opt/stack/gerrit-powered-agenda/icals/
The generated .ics files are not tracked in this git repository,
but they are available locally to import into your calendar. Note,
to remove stale .ics files, use the ``--force`` argument:
::
gerrit-powered-agenda/icals$ ls
Barbican Meeting-b58d78a4.ics
Ceilometer Team Meeting-9ed7b5b4.ics
Chef Cookbook Meeting-2418b331.ics
::
gerrit-powered-agenda/icals$ ls
Barbican Meeting-b58d78a4.ics
Ceilometer Team Meeting-9ed7b5b4.ics
Chef Cookbook Meeting-2418b331.ics
With each .ics file looking something similar to:
::
gerrit-powered-agenda/icals$ cat Barbican\ Meeting-b58d78a4.ics
BEGIN:VCALENDAR
VERSION:2.0
PRODID:-//OpenStack//Gerrit-Powered Meeting Agendas//EN
BEGIN:VEVENT
SUMMARY:Barbican Meeting (openstack-meeting-alt)
DTSTART;VALUE=DATE-TIME:20141006T200000Z
DURATION:PT1H
DESCRIPTION:Project: Barbican Meeting\nChair: jraim\nIRC: openstack-meet
ing-alt\nAgenda:'* malini - update on Security Guide documentation\n\n *
alee_/atiwari - Crypto plugin changes\n\n * arunkant - Target support in
barbican policy enforcement\n\n * jaraim - Support for debug mode start i
n barbican\, can be merged?\n\n '\n\nDescription: The Barbican project t
eam holds a weekly team meeting in\n#openstack-meeting-alt:\n* Weekly on M
ondays at 2000 UTC\n* The blueprints that are used as a basis for the Barb
ican project can be\n found at https://blueprints.launchpad.net/barbican\
n* Notes for previous meetings can be found here.\n* Chair (to contact for
more information): jraim (#openstack-barbican @\n Freenode)\n
RRULE:FREQ=WEEKLY
END:VEVENT
END:VCALENDAR
::
gerrit-powered-agenda/icals$ cat Barbican\ Meeting-b58d78a4.ics
BEGIN:VCALENDAR
VERSION:2.0
PRODID:-//OpenStack//Gerrit-Powered Meeting Agendas//EN
BEGIN:VEVENT
SUMMARY:Barbican Meeting (openstack-meeting-alt)
DTSTART;VALUE=DATE-TIME:20141006T200000Z
DURATION:PT1H
DESCRIPTION:Project: Barbican Meeting\nChair: jraim\nIRC: openstack-meet
ing-alt\nAgenda:'* malini - update on Security Guide documentation\n\n *
alee_/atiwari - Crypto plugin changes\n\n * arunkant - Target support in
barbican policy enforcement\n\n * jaraim - Support for debug mode start i
n barbican\, can be merged?\n\n '\n\nDescription: The Barbican project t
eam holds a weekly team meeting in\n#openstack-meeting-alt:\n* Weekly on M
ondays at 2000 UTC\n* The blueprints that are used as a basis for the Barb
ican project can be\n found at https://blueprints.launchpad.net/barbican\
n* Notes for previous meetings can be found here.\n* Chair (to contact for
more information): jraim (#openstack-barbican @\n Freenode)\n
RRULE:FREQ=WEEKLY
END:VEVENT
END:VCALENDAR
YAML Meeting File
@ -129,6 +135,7 @@ will be import into Python as a dictionary.
* The project name is shown below.
::
project: Nova Team Meeting
* The schedule is a list of dictionaries each consisting of `time` in UTC,
@ -137,6 +144,7 @@ will be import into Python as a dictionary.
`biweekly-odd` at the moment.
::
schedule:
- time: '1400'
day: Thursday
@ -152,12 +160,14 @@ will be import into Python as a dictionary.
chair.
::
chair: Russell Bryant
* The project description is as follows. Use `>` for paragraphs where new
lines are folded, or `|` for paragraphs where new lines are preserved.
::
description: >
This meeting is a weekly gathering of developers working on OpenStack.
Compute (Nova). We cover topics such as release planning and status,
@ -170,6 +180,7 @@ will be import into Python as a dictionary.
sub-item of a sub-item.
::
agenda: |
* General announcement
* Sub-teams