W3C home > Mailing lists > Public > public-dxwg-wg@w3.org > January 2018

My understanding of minutes, meetings, rrsagent

From: Karen Coyle <kcoyle@kcoyle.net>
Date: Tue, 16 Jan 2018 15:24:04 -0800
To: "public-dxwg-wg@w3.org" <public-dxwg-wg@w3.org>
Message-ID: <60011016-cbc0-4a30-8d82-a3f9d0a6e366@kcoyle.net>
DAVE RAGGETT - if you can find someone who can confirm my guess here
about how the Meetings page is generated and determines if wiki pages
end up being displayed here, that would be very helpful!

==RRSagent [1]

There is a page that describes rrsagent, but that fails to say WHERE
minutes are stored. I'm making a guess about some details here, but I
think it holds:

- rrsagent works off of IRC and captures the IRC discussion in a log.
- the minutes that are generated take the form of:
    https://www.w3.org/{date in form=yyyy/mm/dd}-{IRC channel}-minutes
   e.g. https://www.w3.org/2018/01/09-dxwg-minutes

Here is the IRC log where I experimented with this:
[15:08] == kcoyle [~kcoyle@public.cloak] has joined #dxwg-test
[15:08] == RRSAgent [rrsagent@public.cloak] has joined #dxwg-test
[15:08] <RRSAgent> logging to https://www.w3.org/2018/01/16-dxwg-test-irc
[15:08] <@kcoyle> rrsagent, make logs public
[15:08] <RRSAgent> I have made the request, kcoyle
[15:08] <@kcoyle> here are some lines
[15:08] <@kcoyle> here are some more lines
[15:08] <@kcoyle> rrsagent, generate minutes
[15:08] <RRSAgent> I have made the request to generate
https://www.w3.org/2018/01/16-dxwg-test-minutes.html kcoyle

The minutes could be prettier with rrsagent commands setting the group
and topic. See the documentation.

- to use RRSagent, when you first log onto IRC type:
  /invite rrsagent #channel
- then make sure the logs are public
  rrsagent, make logs public
  (minutes will also be public)
- to general minutes
  rrsagent, create minutes

To use q?+- and other commands you need Zakim [2]
   /invite Zakim #channel

== Meetings page, minutes

The meetings page section with meetings is generated "on the fly" from
this wiki temkplate:

{{#ask: [[Category:Meeting]]
| ?Date
| ?Subject
| ?Minutes
| ?Scribe
| sort=Date
| order=ASC
| offset=10
| limit=40
| format=broadtable
}}

== Meeting agenda pages

The wiki page for a meeting starts with this:
[[Category:Meeting]]

and ends:

==Annotations==

* [[Type:: Telecon]]
* [[Subject:: Define profile; sub-group meetings]]
* [[Date::2018-01-16]]
* [[Minutes:: https://www.w3.org/2018/01/16-dxwg-minutes]]
* [[Scribe:: Jaroslav]]

The meeting agenda URL itself is:

https://www.w3.org/2017/dxwg/wiki/Meetings:Telecon{date yyyy.mm.dd}
  e.g. https://www.w3.org/2017/dxwg/wiki/Meetings:Telecon2018.01.16

I cannot find any documentation on the generation of the meeting page. I
note that the minutes for the F2F meetings do not appear on the meetings
page, although the minutes exist. Therefore, there is something else
that is at work here, and I need to experiment some more to see what
makes the meeting agendas and minutes appear.

I did find that the meeting page has only recent meetings and this page
has all of the meetings:
  https://www.w3.org/2017/dxwg/wiki/Category:Meeting
This, too, is auto-generated, from the [[Category:Meeting]] wiki tag.
That's a pretty standard wiki function.

kc

[1] https://www.w3.org/2002/03/RRSAgent
[2[ https://www.w3.org/2001/12/zakim-irc-bot.html
-- 
Karen Coyle
kcoyle@kcoyle.net http://kcoyle.net
m: 1-510-435-8234 (Signal)
skype: kcoylenet/+1-510-984-3600
Received on Tuesday, 16 January 2018 23:24:42 UTC

This archive was generated by hypermail 2.3.1 : Monday, 29 April 2019 13:44:57 UTC