From 2dd14d8b58658c4c48df1df532fe647054cef2b9 Mon Sep 17 00:00:00 2001 From: r12a Date: Tue, 1 Aug 2017 12:52:44 +0100 Subject: [PATCH] guidelines/process, changed irc nick name from me to nick: --- guidelines/process.html | 40 ++++++++++++++++++++-------------------- 1 file changed, 20 insertions(+), 20 deletions(-) diff --git a/guidelines/process.html b/guidelines/process.html index 56cedec..62df65c 100644 --- a/guidelines/process.html +++ b/guidelines/process.html @@ -132,18 +132,18 @@

Starting a telecon

You may want to set up a list of agenda items . Do this in IRC using this pattern:

-
me    agenda+ Action item review 
-me    agenda+ Issue review
-me    agenda+ Do this
-me    agenda+ Do that 
+  
mynick:    agenda+ Action item review 
+mynick:    agenda+ Issue review
+mynick:    agenda+ Do this
+mynick:    agenda+ Do that 
 ...

If you have regrets from some participants, indicate that for the minutes by typing:

-
me    regrets+ personsname anotherperson etc
+  
mynick:    regrets+ personsname anotherperson etc
 

You'll need to set up someone as a scribe (to take the minutes). To do so, type:

-
me    scribenick: persons_irc_nickname
+
mynick:    scribenick: persons_irc_nickname

Depending on how your telecon is set up, you may need to claim the host role to start the meeting. To do this.....

@@ -151,7 +151,7 @@

Starting a telecon

You should sign in when you join the call by typing into IRC:

-
me    present+ myname 
+  
mynick:    present+ myname 
 

This records you as present in the minutes, and the zakim bot keeps track of participants this way.

@@ -165,25 +165,25 @@

During a telecon

To start a new topic type:

-
 me    Topic: title_of_the_topic_here
+
 mynick:    Topic: title_of_the_topic_here

Alternatively, if you have set up an agenda on IRC, you can type:

-
me     zakim, take up agendum X
+
mynick:     zakim, take up agendum X

where X is the number of the agenda item. You don't need to progress through the agenda sequentially. Setting the topic will automatically create a linked heading in the minutes.

To check what's on the agenda , type

-
me    agenda?
+
mynick:    agenda?

To give someone an action , type

-
me    Action: Person's_nickname to do something
+  
mynick:    Action: Person's_nickname to do something
 

Note that the person's name needs to be the one the bot recognises, and that the word 'to' is important for the action to be recognised by the bot.

To close an action , such as action number 10, simply type

-
me    close action-10
+  
mynick:    close action-10
 

Depending on how your telecon is set up, you may need to claim the host role @@ -191,7 +191,7 @@

During a telecon

Anyone can correct the minutes in IRC using the substitution command. For example, the following will change the record in the minutes.

-
me    s/@@ said he would do it/David said he would NOT do it/
+  
mynick:    s/@@ said he would do it/David said he would NOT do it/
 
@@ -202,14 +202,14 @@

Scribing

You need to tell the bot who the scribe is . Do this by typing in IRC:

-
me    scribenick: person's_nickname
+
mynick:    scribenick: person's_nickname

Doing this will produce much tidier and more readable minutes.

To scribe what someone is saying , type the name/nick of that person followed by a colon, then add what they say. You can continue the same person's comments by starting a new line with ... (three dots). The bot will then stitch the lines together when it produces the minutes. So, for example:

-
 me    r12a: this is me scribing what someone is saying
- me    ... and now i'm adding something else they are saying
- me    ... and yet more!
+
 mynick:    r12a: this is me scribing what someone is saying
+ mynick:    ... and now i'm adding something else they are saying
+ mynick:    ... and yet more!

There not much more to it than that. But don't forget to save the minutes before the end of the call and before dismissing rrsagent!

@@ -221,19 +221,19 @@

Creating minutes

You need to ensure that the rrsagent bot is on the IRC channel before starting to record minutes. If you start the meeting using trackbot, it will usually start up rrsagent automatically. Otherwise, do this in IRC:

-
me    /invite #channel_name rrsagent
+
mynick:    /invite #channel_name rrsagent

If you don't have rrsagent running, producing minutes will be a major hassle.

To tell rrsagent to draft the minutes , type the following:

-
 me    rrsagent, draft minutes
+  
 mynick:    rrsagent, draft minutes
 

The bot will reply to you with a URL where the minutes are being stored. (It may take a moment for the page to refresh.)

You should ALWAYS ask rrsagent to draft the minutes at the end of the telecon, but you can also do so at any time during the call.

You may need to set the access rights for the minutes . You can do this in IRC using:

-
 me    rrsagent, make log public
+  
 mynick:    rrsagent, make log public
 

Once the meeting is finished, the chair or scribe should check that the minutes look ok. If you want to change anything in the minutes page, use the substitution command mentioned above (ie. s/xxx/yyy/). You'll need to do this before dismissing rrsagent!

Finally,