Warning:
This wiki has been archived and is now read-only.
Scribe Conventions
From SPARQL Working Group
Contents
Before scribing
- Invite Zakim and RRSagent
/invite Zakim /invite RRSagent
- Set the topic of the meeting to the meeting agenda
/topic <URL of meeting agenda>
- Set the meeting
Zakim, this will be sparql
- Set the scribe
ScribeNick: <scribe>
- Make records public
RRSAgent, make records public
While scribing
This is a subset of all the features supported by Scribe.perl. This should be all about scribing a SPARQL WG scribe needs to know. See also Scribe List and Etiquette.
Scribe Activity | IRC syntax | Example |
---|---|---|
Declare who is scribing | ScribeNick: <irc nickname of scribe> | ScribeNick: LeeF |
Recording what someone says | <name>: <text of what they said> | EricP: I don't think that's a good idea |
Shortcut for more from the same speaker | ... <additional text> | ... because it will never work |
Correcting mistakes | s/<old text>/<new text>/ | s/it will/it would/ |
Assigning Action Items | ACTION: <name> to <what they are supposed to do> | ACTION: LeeF to 'borrow' useful information from the OWL WG wiki |
Setting Topic (optional) | Topic: <title of new topic> | Topic: How to Scribe Effectively |
Proposals | PROPOSED: <proposal text> | PROPOSED: The first thing we do, let's kill all the lawyers. |
Resolutions (after voting) | RESOLVED: <proposal text reiterated> | RESOLVED: The first thing we do, let's kill all the lawyers. |
After scribing (New Style Minutes)
- Copy the chat log to the wiki. e-mail about this
- Let ?yyyy, ?mm and ?dd be the year, month and date of the teleconf
- e.g., if the teleconf was on 18 June 2008, then we have ?yyyy=2008, ?mm=06 and ?dd=18
- Copy the RSS agent log at:
http://www.w3.org/?yyyy/?mm/?dd-sparql-irc.txt
to a wiki page at:http://www.w3.org/2009/SPARQL/wiki/Chatlog_?yyyy-?mm-?dd
- Find "Zakim, who is here?" command
- Let ?names be the list of attendees from the above command
- The names in this list should be unambiguous with respect to Participants2.
- Add these three lines before the copied ones:
{{chatlog|rrsagent=http://www.w3.org/?yyyy/?mm/?dd-sparql-irc|chatlog={{fullurl:{{PAGENAME}}}}}}
<pre><nowiki>
00:00:00 <scribenick> PRESENT: ?names
- Replace in the 'chatlog' template the variables ?yyyy, ?mm and ?dd by the concrete year, month and day, respectively.
- After this line names only have to be unambiguous with respect to the "PRESENT:" list
- Add this line after the copied ones (i.e., at the end):
</nowiki></pre>
- Let ?yyyy, ?mm and ?dd be the year, month and date of the teleconf
- If someone writes a line of the form "word: text" that is not really a scribe-assist, then insert a space before the word.
- Optionally add "Subtopic:" and even "Subsubtopic:" entries
- Optionally use "omit:" to "comment out" lines which you don't want to delete (because you're not sure they should be gone).
- Optionally add "summary:" lines (one per topic/subtopic) giving a summary of that section
- Check the agenda for regrets, and add them to the minutes, by adding a line of the form:
00:00:00 <scribenick> REGRETS: ?names
- Add the chair:
00:00:00 <scribenick> CHAIR: ?name
- Add yourself to the bottom of the Scribe List
After scribing (Old Style Minutes)
The scribe is responsible to clean up the meeting minutes. In the past this has included a number of items
- Remove Zakim chit chat such as people entering, leaving, q+, acks, who is here, etc.
- Move scribes own comments (as opposed) into irc syntax
- Reorder to make discussions more coherent, particularly IRC comments out-of-order
- Remove extraneous chit-chat, particularly at the beginning of the TC, and Zakim requests like q+
- Add section headers
- Adding
{{Action|4}}
and{{Issue|23}}
links where the trackbot has failed to do this correctly. - Check the agenda for regrets, and add them to the minutes.
- Add yourself to the bottom of the scribe list