13:50:27 RRSAgent has joined #chairing 13:50:27 logging to http://www.w3.org/2014/04/24-chairing-irc 13:50:37 rrsagent, please make record public 13:50:55 Meeting: Chair Training Module 2: Tools 13:51:08 dveditz has joined #chairing 13:53:22 nigel has joined #chairing 13:54:34 Team_ChTr(TOOLS)10:00AM has now started 13:54:41 +Ralph 13:55:53 acoleman has joined #chairing 13:56:24 +Jeff 13:56:26 +??P4 13:56:46 +[IPcaller] 13:56:47 Lisa_Seeman has joined #chairing 13:56:59 zakim, [IPcaller] is Joshue 13:56:59 +Joshue; got it 13:57:06 zakim, mute me 13:57:06 Joshue should now be muted 13:57:10 + +1.617.299.aaaa 13:57:31 zakim, mute me 13:57:31 sorry, Lisa_Seeman, I do not know which phone connection belongs to you 13:57:54 zakim, lisa is Lisa_Seeman 13:57:54 +Lisa_Seeman; got it 13:57:58 zakim, mute me 13:57:58 Lisa_Seeman should now be muted 13:58:15 zakim, aaaa is ScottP 13:58:15 +ScottP; got it 13:58:28 jeff has joined #chairing 13:59:48 christine has joined #chairing 14:00:17 +shawn 14:00:37 Vlad has joined #chairing 14:00:37 scottp has joined #chairing 14:01:05 Arnaud1 has joined #chairing 14:01:12 gmandyam has joined #chairing 14:01:16 [gold stars for the five who arrived on time] 14:01:27 +Andy_Coleman 14:01:35 +Vlad 14:01:41 + +1.908.559.aabb 14:01:45 +Arnaud 14:01:46 +gmandyam 14:01:50 +[IPcaller] 14:01:51 +AWK 14:02:00 Zakim, IP caller is me 14:02:00 I don't understand 'IP caller is me', christine 14:02:06 yosuke has joined #chairing 14:02:09 Zakim, IPcaller is me 14:02:09 +christine; got it 14:02:13 AWK has joined #chairing 14:02:14 Giri Mandyam from Qualcomm Innovation Center dialing in 14:02:15 +SteveZ 14:02:16 zakim, mute me 14:02:16 shawn should now be muted 14:02:52 wseltzer has joined #chairing 14:03:08 zakim, code? 14:03:08 the conference code is 24872 (tel:+1.617.761.6200 sip:zakim@voip.w3.org), wseltzer 14:03:17 dan has joined #chairing 14:03:26 SteveZ has joined #chairing 14:03:32 Sharron has joined #chairing 14:03:52 srush has joined #chairing 14:03:53 +Wendy 14:04:19 scribenick: wseltzer 14:04:21 -> http://www.w3.org/2014/Talks/0423-tools-rrs/ Tools for W3C Groups 14:04:24 +dveditz 14:04:46 Ralph: This session is part 2 of a 4-part series 14:04:54 ... training for W3C group chairs 14:05:00 +??P28 14:05:08 ... Next 2 sessions will cover facilitation topics 14:05:11 [slide2] 14:05:22 ... This session is being recorded. 14:05:24 + +1.818.434.aacc 14:05:48 +[IPcaller] 14:05:56 ... Slides are publicly accessible; we expect to make the minutes available. 14:06:10 ... Also audio, if of sufficient quality. Transcript, someday. 14:06:16 [slide3] 14:06:31 s/... This/Ralph: This/ 14:08:13 zakim, ??P28 is me 14:08:13 +Sharron; got it 14:08:14 Ralph: every categorization scheme needs a miscellaneous topic. Hence, "other tasks" 14:08:45 ... I'll try to listen to questions, will likely defer response 14:08:48 [slide4] 14:09:30 Ralph: Use your favorite text-editing or markup-editing tool 14:10:16 ... many new team members use BlueGriffon 14:10:34 ... but any markup editor of your/your document editor's choice is fine with us. 14:10:43 ... How to get content onto the W3C site? several ways. 14:11:04 ... We support WebDAV 14:11:32 ... The entire W3C website (minus wikis and blogs) is maintained in CVS 14:11:50 ... Direct HTTP write access 14:12:24 ... We support Mercurial repos, git 14:13:02 ... Access control supports all the previous items. 14:13:21 ... Amaya, mentioned for historical reasons. Web browser that supported editing. 14:13:43 ... Unfortunately, it is no longer actively maintained. 14:14:17 [slide5] 14:14:45 Ralph: WebDAV, linked a guide, invite updates. 14:15:22 ... One feature of WebDAV in many OSes is a standard file-system view 14:16:10 ... Take care. It's folder-oriented and easy to delete what you want or don't mean to delete. 14:16:41 ... Save-as looks like local. 14:16:55 ... Most general and simplest format for arbirtrary text markup editors. 14:16:59 [slide6] 14:17:33 Ralph: CVS is what we use. Other things are interfaces on top of CVS store 14:17:49 -> https://www.w3.org/Project/CVSdoc/ CVS at W3C 14:18:55 Ralph: conceptual differences between git and cvs are small, though UI differences are lareger 14:19:01 s/lareger/larger/ 14:19:16 [slide7] 14:19:34 Ralph: HTTP PUT has been specified since day 0. 14:20:26 ... edit.w3.org is the service that provides HTTP PUT 14:21:22 ... I go through this in detail because one of your responsibilities as a chair is to provide and maintain group homepages, with information about what your group is doing. 14:21:29 [slide8] 14:21:59 Ralph: As CVS was aging, we looked around, and at that time, Mercurial (hg) was nominated. 14:22:46 ... dvcs.w3.org is our w3c-hosted hg instance 14:23:20 ... We expect to provide persistence for the mercurial store as we do for the rest of our site 14:24:10 ... Developers who are both writing code and participating as editors will tend to have tool preferences 14:24:22 ... We're still working on how best to integrate git and github 14:24:29 ... with the w3.org site. 14:24:49 [slide9] 14:25:06 Ralph: Underlying fine-grained access control mechanism 14:25:47 ... Unlike many webservers, where ACLs are per-directory, W3C site has per-resource ACLs 14:26:21 ... "Date space" (whether fondly or less fondly called) /YYYY/MM/ 14:26:30 ... all under fine-grained access-control 14:26:52 ... Allows us to create a working group home under date space 14:26:59 +Jim_Allan 14:27:03 ... with write-access to any appropriate member of your WG 14:27:29 ... you as chairs will have HTTP PUT access there 14:28:09 allanj has joined #chairing 14:28:36 ... If you've created a group area and provided access to editors, there's also a tool allowing you to set default ACLs for new documents there 14:28:54 -> http://www.w3.org/2002/02/auto-acl Predefined ACLs 14:29:23 Ralph: That was the general description of how things get on the W3C website. 14:29:37 ... Next, I'll talk more specifically about the technical report production workflow. 14:29:41 [slide10] 14:30:02 -> http://www.w3.org/2003/Editors/ W3C Editors' Home Page 14:30:38 Ralph: House style, not enforced except through pubrules 14:31:10 ... Markup of specs, tool of choice seems to be ReSpec 14:31:57 ... Tools to help with document revision process: htmldiff, spell checker 14:32:24 s/, spell checker/: inline annotation of html doc differences 14:32:42 ... Services available on W3C site 14:32:50 ... source is also available 14:33:19 ... Spell checking; link-checking; 14:33:50 ... Unicorn: markup validation tools. 14:34:39 ... Pubrules checker is often-cursed 14:35:06 ... but it's nonetheless important 14:35:31 - +1.818.434.aacc 14:36:19 zakim, who is making noise? 14:36:30 wseltzer, listening for 10 seconds I heard sound from the following: Ralph (25%), dveditz (46%) 14:36:47 [slide11] 14:37:04 Ralph: Respec. 14:37:45 ... Puts in much of the boilerplate template 14:39:03 ... As efforts to revise rec-track process or publishing format proceed, 14:39:14 ... there may be more encouragement to use ReSpec 14:39:45 ... I have heard strong suggestions that documents using ReSpec will be more flexible 14:40:20 ... and extensible, because ReSpec captures metadata 14:40:50 ... Start from a template 14:41:00 -> http://www.w3.org/respec/examples/template.html ReSpec template 14:41:05 [slide12] 14:41:29 Ralph: link checker, allows recursion 14:43:03 ... ,checklink 14:43:55 Not knowing who is chairing or who scribed recently, I propose +1.908.559.aabb 14:44:29 [slide13] 14:44:54 Ralph: Unicorn, a multiple markup validator. 14:45:05 ... a required step in spec publication pipeline, pubrules 14:45:49 ... Validator Suite offers recursive testing 14:46:12 ... but you will be validating pages as you create them 14:46:26 [slide14] 14:46:55 -Joshue 14:46:55 Ralph: pubrules checks for required header material 14:48:17 [slide15] 14:48:28 Ralph: tools for managing discussion 14:48:54 ... primary tools: tracker, bugzilla, lc comments tracker 14:48:56 + +46.8.50.51.aadd 14:49:08 [slide16] 14:49:13 Ralph: We have a public bugzilla instance 14:50:00 ... no requirement that you use bugzilla, but many find it useful, e.g. HTML WG 14:50:18 hta has joined #chairing 14:50:56 ... at major transition points, LC->CR, CR->PR, director will ask for verification that your group has responded to comments 14:51:27 ... if you're using bugzilla to track comments, these scripts will help generate disposition of comments 14:51:55 ... bugs2html bugzilla.xsl 14:53:52 [slide17] 14:55:06 Ralph: Last Call Comment Tracker, provides means to track comments, annotate, and reply 14:56:16 ... use of the particular tool is optional, but producing the report is required 14:56:46 ... Meeting management and recordkeeping 14:56:49 [slide 18] 14:56:50 [slide18] 14:56:56 scribenick: dveditz 14:57:20 tools: irc (e.g. this #chairing channel) 14:58:21 ... Zakim, name refers to two separate services (HW conf bridge, IRC agent) 14:58:45 ... RRSAgent is the tool for recording meetings 14:58:58 ... tracker is the tool for actions and issues 14:59:26 ... WBS, scribe.perl (HTML formatted meeting notes) 14:59:47 Sorry, have to leave now 14:59:52 -Vlad 14:59:57 ... link to Scribe 101 -- an introduction to how to run meetings and use these tools. 15:00:12 -Wendy 15:00:25 ... last link is more information on using these tools 15:00:33 [slide 19] 15:01:20 ... link to reserving a teleconference slot (bridge physical capacity is limited) 15:02:07 ... reserved via email messages, details at that link 15:02:56 ... Zakim commands are documented, managing the speaker queue and agenda can be done via zakim 15:03:43 ... several styles these tools can be used, link to a document with hints and kinks you might find yourself in. tricks on how to use Zakim for specific situations 15:03:47 jeff has joined #chairing 15:03:55 ... (please feel free to add your own tips to the wiki page) 15:04:31 [slide 20] 15:04:41 ... many groups find the parts of zakim that manage speaker tools can be useful apart from the teleconferencing bridge, invite Zakim into your channel 15:04:50 [slide 20] 15:05:08 ... RRSAgent can be invited into a channel as well 15:05:36 ... there's a timelag for RRSAgent, but if it's more than 2-3 minutes it's probably stuck. send a trouble report 15:06:00 ... both zakim and rrsagent need to be invited into your specific channel 15:06:11 -Jeff 15:06:30 ... /invite rrsagent #chairing for example 15:06:40 [slide 21] 15:06:43 ... tracker 15:07:08 ... has a config db and knows about regular channels and meetings 15:07:26 ... it will invite zakim and rrsagent for you and set up the mtg record 15:07:43 ... and format the meeting notes later 15:07:59 ... real use is to manage a db of action items, your group's issues, and track resolutions 15:08:19 .... tracker itself is the latest in several variations on the same theme 15:08:32 ... tracker has been designed and tuned for the w3c community style 15:08:39 ... 3 interfaces 15:09:21 ... (links) trackbot irc interface (not present in this specific channel, but you're welcome to ask the systems team to set it up for your channel) 15:09:34 ... web interface to the tracker -- superset of the IRC interface 15:10:08 ... and an email interface to your WG's mailing list 15:10:31 ... tracker will identify msgs that refer to specific actions and include those messages in with the history of that action 15:10:58 ... depending on how good your group members are at including the magic keywords in the messages 15:11:29 ... best keeping messages about one issue in separate from messages abouot other issues. 15:11:44 ... if they're combined sometimes the same mail gets included into multiple issue records 15:12:28 ... traditionally tracker is configured to always be present on your channel, very convenient to ask about specific issues 15:12:35 ... when a mtg is in progress 15:13:08 ... when using bugzilla or LC tracker there's a tool for creating the Director's last call comments (record?) 15:13:33 ... DisCo: that script expects a specific style of comments (link in slide) 15:14:10 ... if you use tracker to track your last call comments that's a fine thing to do, but look at the documentation for DisCo so you know ahead of time what style comment the tool is looking for 15:14:16 [slide 22] 15:14:35 ... these 3 tools can be a source of confusion for your members 15:15:07 ... for some need to address the bot directly ("Zakim, " "trackbot, )") 15:15:35 ... zakim does teleconferencing management 15:15:46 ... rrsagent is a record keeping function 15:16:11 ... trackbot interfaces with the actions and issues database. 15:16:34 +??P17 15:16:45 zakim, ??P17 is me 15:16:45 +nigel; got it 15:16:45 ... rrsagent has some recognition of issues and actions, trackbot recognizes the same things 15:16:51 [slide 23] 15:17:03 zakim, mute me 15:17:03 nigel should now be muted 15:17:09 ... web-based strawpoll info gathering tool 15:18:02 ... when creating a poll using WBS there are templates for common situations: teleconferencing scheduling, meeting times, 15:18:09 ... not a common place to find these 15:19:04 ... any questionnaire you find where you like its style you can grab a copy and adapt it to your needs 15:19:15 ... link at top of slide 23 15:19:25 ... to detailed documentation on WBS 15:20:05 [slide 24] 15:20:13 ... last of the tools is scribe.perl 15:20:43 ... nrmally you don't see this directly, bundled in with rrsagent functionality usually 15:21:13 ... link to editing commands to making corrections to what the scribe has recorded 15:22:19 ... scribe.perl can be invoked independently of rrsagent -- useful if you need to generate minutes the day after the meeting (for example) 15:22:30 ... rrsagent wouldn't know the correct date at that point 15:22:47 [slide 25] 15:22:54 ... "Other"... 15:23:30 ... needs it's own meeting: how do we test a specification. "Test the Web Forward" 15:23:55 ... repository hosted by W3C (thanks to Toby (?) for donating that to us) 15:24:27 ... contains a primer on getting started with git and github 15:24:58 ... if your group is using that and have some members that are unfamiliar with those tools 15:25:41 ... comments or questions about the the testing workflow the public-test-infra list is the best place 15:25:58 ... we use MediaWiki to manage all our wikis (public, group, private) 15:26:06 ... link to style hints and suggestions 15:26:50 ... our blogging environment is Wordpress -- link to how to request a blog for your WG if you want to use that 15:27:13 ... link to Slidy, a presentation tool (used in this presentation, for example) 15:27:35 ... I like Slidy, the format is HTML and that's a familiar environment for many 15:27:44 [slide 27] 15:28:01 ... more information available on the w3 tools wiki 15:28:34 ... a little out of date, but still useful 15:28:52 ... I mentioned earlier re link-checker that there was a shortcut 15:29:11 ... add ",checklink" to end of URLs on w3.org 15:29:20 ... there are other "comma" tools 15:29:34 oops, [slide 26], not 27 15:30:10 ... ",minutes", pretty print text ",text", ",validate" runs the validator 15:30:21 ... ",pubrules", 15:30:37 ... ",pubruleserrors" shows the errors generated 15:30:52 ... mailing list link for more questions on these tools 15:30:56 [slide 27] 15:31:07 ... thanks to all for the development of the tools I've described here 15:31:36 ... please let us know your own favorite ways to work with or around these tools 15:31:48 ... and we'll add the best to the guidebook and the tools wiki 15:32:14 I think I'm muted.... 15:32:15 +q 15:32:20 zamik, unmute me 15:32:21 zakim, who is on the phone? 15:32:21 On the phone I see Ralph, Lisa_Seeman (muted), ScottP, shawn (muted), Andy_Coleman, +1.908.559.aabb, Arnaud, gmandyam, christine, AWK, SteveZ, dveditz (muted), Sharron, yosuke, 15:32:24 ... Jim_Allan, +46.8.50.51.aadd, nigel (muted) 15:32:34 AWK has joined #chairing 15:33:04 Arnaud: I find the last call tracker tool hard to use 15:33:29 ... hard to remember the arcane details 15:33:38 Agree re: comment tracker. The filtering mechanism is broken in unpredictable ways that make it difficult to rely on. 15:33:43 ... if you're looking for a tool that needs help I recommend this one 15:34:01 Ralph: what's your favorite tool that you've used for things like this? 15:34:20 Arnaud1: I've seen people use simple wiki pages, pretty bare but easier to use 15:34:40 ... the intention is good, but the implementation is not. If I had to do it again I'd do it by hand because at least you know exactly what's going on 15:35:05 Ralph: I'm hearing that you struggle with LC tracker, and prefer to do it "by hand" 15:35:16 ... I don't know hen we'll have resources to revise any of these tools 15:35:21 Thanks, and apologies. I need to leave the call. 15:35:23 q+ to ask who to notify about issues with tools 15:35:29 -christine 15:35:42 Arnaud1: the status is that this is not an officially supported tool but .... group used "comment-scribe" 15:35:55 CommonScribe 15:36:03 ... will transform minutes into nicely formatted comments 15:36:36 Ralph: thanks for mentioning CommonScribe... Sandra's done a nice job with it 15:36:57 ... most of these tools were developed by individuals trying to make a repetitive task they had to do easier 15:37:12 .... everyone of these tools started as a midnight hack by some individual 15:37:46 ... CommonScribe is a very useful tool, hasn't yet made the transition from "Sandra's project" to officially supported by the systems team but I agree it's a nice tool 15:37:59 s/Sandra/Sandro/ 15:38:09 ... can't recommend it to other WG chairs who don't have the benefit of Sandra in your group to fix things when it goes wrong 15:38:29 AWK, you wanted to ask who to notify about issues with tools 15:38:40 Arnaud1: It's a good tool but I also would not recommend it to groups without Sandro present 15:38:56 AWK: I like the tracker tool, we use it all the time, but aspects we can't use 15:39:26 ... when comments are sent to the list the tool offers the ability to import from a URL but it never works. who do we talk to about that? 15:39:48 mailto:sysreq@w3.org for bugs 15:39:58 Ralph: if you're having difficulty ith a documented feature that doesn't work send mail to sysreq@w3.org 15:40:16 ... I owuld characterize that as a bug and that's perfectly appropriate 15:40:34 mailto:w3t-sys@w3.org for feature requests 15:40:43 ... feature requests can go to w3t-sys@w3.org 15:41:09 mailto:w3c-tools@w3.org for dicussion 15:41:38 ... for collaboration on tool devleopment I recommend w3c-tools@w3.org I think that's an underutilized list for discussions about tools needs 15:41:59 irc channel #sysreq works well when looking for quick remedies - like some system down 15:42:42 ... Arnaud1 commented in irc that there's also the #sysreq irc channel. no promises it's monitored 24/7 but it often is 15:43:17 Arnaud1: I will add that even if you join and it looks like no one's there, the sysreq team has tools and will be notified when you post something there 15:44:06 Ralph: thx for mentioning that. unlike most channels you won't necessarily see people just sitting there. When you type there it interrupts other channels the sysreq folks are watching 15:44:10 ... like a paging system 15:44:29 ... any other favorite tools you'd like to share 15:44:40 Joshue has joined #chairing 15:44:58 ... I perhaps disparaged by omission many tools that have been used in the past or are still being used 15:45:20 ... In this presentation I chose the tools that are most commen and current best practices 15:45:27 ... but there are others that can be useful 15:45:39 ... thanks for expressing your interest by attending 15:46:09 -AWK 15:46:10 -shawn 15:46:11 ... stay safe out there with w3 tools, and please share your experiences with us so we can improve tools and future chairs can benefit from you 15:46:12 - +1.908.559.aabb 15:46:12 -gmandyam 15:46:13 [thanks to Ralph.. ] 15:46:14 -Arnaud 15:46:15 - +46.8.50.51.aadd 15:46:16 -Andy_Coleman 15:46:17 -nigel 15:46:19 -Sharron 15:46:20 -ScottP 15:46:21 -yosuke 15:46:22 shawn has left #chairing 15:46:23 -SteveZ 15:46:29 -Lisa_Seeman 15:46:51 -dveditz 15:46:54 not sure what to do scribewise at this point... 15:46:56 -Jim_Allan 15:47:20 scottp has left #chairing 15:47:25 [no problem, dveditz ; I'll take it from here. Thanks very much for picking up the scribe task] 15:47:38 I guess I should go read the link on the slides now :-) 15:47:48 for next time 15:47:52 -Ralph 15:47:57 :) 15:48:02 Team_ChTr(TOOLS)10:00AM has ended 15:48:03 Attendees were Ralph, Jeff, Joshue, +1.617.299.aaaa, Lisa_Seeman, ScottP, shawn, Andy_Coleman, Vlad, +1.908.559.aabb, Arnaud, gmandyam, AWK, christine, SteveZ, Wendy, dveditz, 15:48:03 ... +1.818.434.aacc, yosuke, Sharron, Jim_Allan, +46.8.50.51.aadd, nigel 15:48:13 [watch and learn, then :)] 15:48:20 rrsagent, please draft minutes 15:48:20 I have made the request to generate http://www.w3.org/2014/04/24-chairing-minutes.html Ralph 15:48:52 [that step takes a moment until the minutes are available] 15:48:58 slick ... all my typos preserved forever :-) 15:49:03 it's already there 15:49:09 guess rssagent asn't that busy 15:49:29 (gah, I really need to fix the sticky 'w' on this keyboard) 15:49:48 thanks 15:49:53 so, what's your least favorite typo? 15:50:28 sorry I didn't know Sandro wasn't Sandra 15:50:33 s/comment-scribe/CommonScribe/ 15:50:38 and that 15:50:43 s/Sandra/Sandro/ 15:51:06 rrsagent, please draft minutes 15:51:06 I have made the request to generate http://www.w3.org/2014/04/24-chairing-minutes.html Ralph 15:51:16 do those s/ editing commands actually change the minutes, or were those informational to me? 15:51:23 they do change the minutes 15:51:42 anyone in the channel can use them to help out the scribe 15:51:50 ah handy 15:51:59 very much so 15:52:43 another oft-used trick: when the scribe has difficulty hearing or keeping up, use "@@" as a signal for "help, please" 15:53:09 Ralph: Fred particularly likes @@ 15:53:10 ... 15:53:43 this is a hint to come back and fill in the @@ -- with s/@@/macaroni and cheese/ 15:53:50 so the minutes capture everything in the channel, not just what the scribe types 15:54:04 almost everything 15:54:13 see RRSAgent documentation 15:55:12 yup, lots of links to read through 15:55:32 most commands to Zakim are recorded in the raw typescript but then elided (by scribe.perl) from the minutes; e.g. "zakim, mute Alex" 15:55:52 a lot you learn by example :) 15:55:54 quite a good list, thanks for collecting it all. Those were all tools I've run into and didn't know who to control 15:56:16 s/who/ho/ 15:56:21 how, dammit 15:56:25 :) 15:56:36 off to fry's for a keyboard I guess 15:56:45 thanks! 15:56:51 my favorite place :) 15:56:57 dveditz has left #chairing 15:58:29 Zakim has left #chairing 15:59:25 jeff has joined #chairing 16:08:04 Sharron has left #chairing 16:15:08 rrsagent, bye 16:15:08 I see no action items