00:00:30 #startmeeting Docs Project Meeting - Agenda: http://fedoraproject.org/wiki/Docs_Project_meetings 00:00:31 Meeting started Thu Feb 18 00:00:30 2010 UTC. The chair is sparks. Information about MeetBot at http://wiki.debian.org/MeetBot. 00:00:33 Useful Commands: #action #agreed #halp #info #idea #link #topic. 00:00:36 #topic Roll Call 00:00:40 * sparks 00:00:43 * jjmcd . 00:00:52 #chair jjmcd 00:00:52 Current chairs: jjmcd sparks 00:02:51 need mchua_afk, shaunm es guide owners 00:03:42 you didn't make an announcement on #fedora-docs 00:04:08 * sparks just did 00:05:26 * stickster 00:07:30 Not a lot of people on tonight! 00:07:42 Guess everyone is watching the Olympics 00:09:18 * sparks wonders if we have enough people here to handle the agenda 00:09:53 Well, we need shaunm for the summit, but all we really wanted was to see if he had everything he needs 00:10:07 ya 00:10:26 everything he needs for live collaboration? 00:10:32 yes 00:10:33 or other stuff as well? 00:10:48 Well, we certainly should ask 00:10:54 hi rudi 00:11:02 hi! 00:11:10 he speaks! 00:11:11 Wow! I can haz talk! 00:11:31 #topic Desktop Help Summit and live collaboration 00:11:35 hi there! 00:11:37 Oh, maybe that doesn't work for me :-) 00:11:44 #chair stickster 00:11:45 Current chairs: jjmcd sparks stickster 00:11:48 #topic Desktop Help Summit and live collaboration 00:12:09 #link http://live.gnome.org/DesktopHelpSummit2010 00:12:18 #info We need shaunm to let us know if he has what he needs for live collaboration, and what he is committed to do there 00:12:48 We should also ask whether there are other areas we could help 00:14:34 jjmcd: I'm writing the email 00:14:41 coolness 00:14:50 #action stickster writing email to list and Shaun to summarize and see if there's anything left for us to do 00:15:01 #info There is a #desktop-help channel set up on Freenode, with zodbot eagerly awaiting 00:16:04 Anything other than IRC or F-Talk? 00:16:11 zodbot is so patient 00:16:47 Not that we know of. He was going to check phones, projectors. We did ask about multiple projectors but not sure if needed 00:17:11 * stickster sent email 00:17:19 * stickster moves that we move on 00:17:25 ok 00:17:32 #topic Release Notes 00:17:39 OK 00:17:55 mchua was going to be here tonight to recruit helpers for alpha 00:18:08 They are still working on talking points as of yesterday 00:18:18 Talking points is a prereq for alpha RNs 00:18:47 Also, cleaned out beats, put link to relevant feature pages in beats where I suspected they might belong 00:18:58 The Talking Points are going to be set by Tuesday 2010-02-23 at the Marketing meeting 00:19:03 but on some features that can be a bit of a challenge 00:19:10 OK, great 00:19:44 So if someone else would like to work with Mel next week (joebus?) that is a short task 00:19:54 OK 00:20:02 What's the task? Writing the alpha RN? 00:20:06 Yes 00:20:15 joebebus: So you're taking that one? 00:20:17 I could try 00:20:21 my best 00:20:28 that's all we ask 00:20:29 I'll make sure I'm around to help 00:20:34 joebebus: We have previous editions available too 00:20:37 Let me find some links 00:20:40 ok 00:20:56 #link http://fedoraproject.org/wiki/Fedora_12_Alpha_release_notes 00:21:09 I'll go check it out 00:21:27 joebebus, mchua is in the UK I think, so not such a huge time delta 00:21:35 joebebus: Keep in mind some sections of that page (top and bottom, really) can probably be copied 00:21:45 Ah 00:21:51 jjmcd: Is mchua_afk traveling there this week? 00:22:02 I thought she was in Rochester NY right now. 00:22:07 Normally she's in Boston area. 00:22:21 OK, her IRC said UK time 00:22:32 but I talked to her late for the UK yesterday 00:22:48 joebebus: Do you think you could have the page created by either Thursday night 2010-02-25 or Friday 2010-02-26? 00:22:50 joebebus, I assume you are eastern or central 00:22:55 central 00:23:14 I never have gotten the time for the meeting correct 00:23:17 bellsouth had to be one of those 00:23:24 yeah 00:23:35 I could probably get it done by one of those dates 00:23:48 joebebus: If you can't, that's OK, but you need to let us know so we can help 00:23:53 ok 00:23:55 If we don't know you can't do it, we can't help :_) 00:23:56 The feature pages are a good place to get some background 00:24:03 Oops, my nose fell off my face --> :-) 00:24:16 I am homeschooled and have no job... so I have plenty of time to commit ;) 00:24:25 But the main feed will be the marketing talking points 00:24:35 It looks like someone's started them here 00:24:36 #link http://fedoraproject.org/wiki/Fedora_13_Alpha_release_notes 00:24:43 So you won't be starting from scratch! 00:24:47 thats good 00:24:51 :-) 00:25:06 #action joebebus to complete draft of F13 Alpha relnotes one-pager on wiki by Friday 2010-02-26 00:25:14 #action jjmcd to bird-dog joebebus 00:26:29 * stickster thanks joebebus, with an extra dollop of gratitude for contributing! 00:26:52 jjmcd: Anything else on release notes? 00:27:00 I am glad to help... I feel like I have been sitting around looking at the IRC logs for too long 00:27:09 No, I think that's it. Status updated on the schedule page 00:27:12 joebebus: That is an awesome pitch-in attitude! 00:27:20 sparks: Move we move on? 00:27:30 Thank you! Im ready to move on 00:27:34 joebebus: Thanks a bunch! 00:27:38 +1000 00:27:44 #topic New Guides 00:27:52 Anyone have a new guide they'd like to discuss? 00:28:08 is there a terminal guide in the works? 00:28:21 I think there is a CLI guide... is that what you mean? 00:28:25 oh yes 00:28:26 sorry 00:28:27 CLI = command line interface 00:28:33 I am used to calling it terminal 00:28:37 Someone one working on one... 00:28:42 ok 00:28:50 I'm sure they wouldn't mind help, tho 00:28:56 ok 00:29:19 move on? 00:29:30 I have nothing else to discuss 00:29:38 go 00:29:53 #topic Guide Status 00:30:06 #link https://fedoraproject.org/wiki/Docs_F13_schedule 00:30:14 none of the guide leaders have yet accepted their schedule 00:30:15 ^^^ That's the link to the schedule for the docs 00:30:46 Sorry; I'll get onto that today 00:30:52 #action email to the list asking guide leads to accept their schedules 00:31:20 * sparks will get on it tonight as well 00:31:42 jjmcd: Did you/we ever come up with updated text to go in the F12 RN and SG for the PolicyKit thing? 00:32:10 No. I was looking for that the other day, couldn't find the bug. DId it get deleted or something? 00:32:22 Not that I'm aware of. 00:32:43 I was going through the F12 bugs and that one never surfaced 00:33:14 Didn't we reference the bug in the RN and SG? 00:33:36 Not in the rn - I'll look in the SG 00:33:42 Should be the same text 00:33:57 RNs were out before we discovered the problem 00:34:13 If I may ask what is the SG? I know the RN is Release Notes... 00:34:19 Security Guide? 00:34:20 SG is the Security Guide 00:34:23 *jinx! 00:34:26 Oh, maybe the common bugs, I'll look 00:34:31 Thank you :-) 00:35:00 * stickster couldn't find that bug in BZ just now either. 00:35:09 hmmm 00:35:21 maybe it was a figment of our imaginations 00:35:33 I swatted all the easy ones and was surprised that one wasn't there 00:36:20 Well, let's decide what to do here and record it, and move on 00:36:37 Do we want to have an update to the relnotes as currently published? 00:36:43 Yes 00:36:50 OK, who's going to make the update and republish? 00:36:59 Well, I'd like to update the F12 docs and remove it from F13 00:37:06 I have a number of fixes in git, just a couple more to do. I will make the update, Sparks will push the rpm 00:37:14 Awesomeness! 00:37:26 I will? I mean, I will! 00:37:39 #action jjmcd to make update to F12 docs in git 00:37:45 Yay! He will! 00:37:48 I think I have 2 others to do before I build the rpm 00:37:53 #action sparks will push F12 updated rpm 00:38:02 oh crud 00:38:03 #undo 00:38:03 Removing item from minutes: 00:38:04 #undo 00:38:04 Removing item from minutes: 00:38:14 #action jjmcd to make update to F12 docs in git to fix PackageKit security information 00:38:21 there ya go 00:38:24 #action sparks will push F12 updated rpm pursuant to jjmcd's change for PackageKit info 00:38:39 Anything else on this? 00:38:46 Is that all? I want to talk about Transifex. 00:38:52 That permission issue is also what was blocking branching 00:39:07 #topic Transifex update 00:39:07 Sorry, PackageKit issue 00:39:29 oops rudi, did I go past you there? 00:39:41 Yeah; but it's no biggie 00:39:53 #undo 00:39:54 Removing item from minutes: 00:39:57 oh bugger 00:40:01 #action sparks will push F12 updated rpm pursuant to jjmcd's change for PackageKit info 00:40:11 Well, sorry zodbot and all :-D 00:40:15 We basically need to craft some weasel words 00:40:18 yeah 00:40:44 #undo 00:40:45 Removing item from minutes: 00:40:49 OK, now we're clean :-) 00:40:54 stickster: You're good, nwo 00:40:55 now 00:41:05 Isn't Transifex for translating documents? 00:41:15 rudi: So the PK issue needs to be fixed before branching? 00:41:21 joebebus: Yes... 00:41:26 ok 00:41:35 I am reading about it 00:41:56 We still have some weeks before we HAVE to branch 00:42:07 I think so, yes 00:42:23 rudi: jjmcd: sparks: Is it just that we want to fix it so the new branch inherits the change? 00:42:28 I'm confused, but that's not new for me 00:42:38 Well... 00:42:47 No, the release notes are a start from scratch 00:42:47 jjmcd -- yeah, this time round though, the branching will also have implications for POT/PO file generation 00:43:06 time out guys 00:43:22 Are we talking about the PackageKit security policy change issue now, or Transifex? 00:43:27 PK 00:43:29 Tfx 00:43:33 LOL 00:43:34 haha 00:43:36 See? 00:43:37 LOL 00:43:39 jjmcd -- including those bits of boilerplate test that don't change much from release to release 00:43:47 rudi: What are YOU talking about? 00:43:56 Yeah, let's get one topic at a time. 00:44:04 Both; the one being the trigger for the other 00:44:18 rudi: How so? 00:44:18 rudi: So can we move the topic to Transifex? 00:44:43 stickster -- it's always been our intention to leave past releases of guides in a buildable state 00:44:57 So once the PK issue is solved in the release notes 00:45:01 #topic Transifec update 00:45:17 We can branch at that point to leave the RN in a (publican 0) buildable state 00:45:23 Transifec? 00:45:26 rudi: I get it. 00:45:37 #undo 00:45:37 Removing item from minutes: 00:45:40 * sparks stops trying 00:45:48 #topic Transifex update 00:45:51 Yeah; so we can then move on to make the Master branch (and therefore F13) Publican 1 buildable 00:45:55 OK, so the F13 branch (Publican 1) waits until we are done with the F12 RPM 00:46:11 Which is a prerequisite for *whatever* Tx solution we go with 00:46:23 jjmcd -- exactly! :) 00:46:33 OK, np 00:46:57 I see the F12 update within the next couple weeks, we have some time before we can actually begin F13 XML 00:46:58 rudi: So are we waiting so that we don't have to enter a second "project" into Tx to handle translating the small bit of fixed content for PK? 00:47:41 stickster, there are another 5-10 bugs already fixed in git waiting for a build so it's not just Pk 00:47:47 More that we can close off the F12 doc in a sane state 00:48:32 O... K... I guess I'm still a bit confused, because I thought the point of branching was to enable that work to continue without holding up the other branch(es) 00:48:40 But let's move on, you don't need to convince me :-) 00:48:54 So... 00:49:15 What's the status of Transifex? I know there were several updates to the ticket but I haven't had a chance to look at them. 00:49:25 There is a staging instance at https://translate.stg.fedoraproject.org/ 00:49:31 It uses your FAS credentials. 00:49:47 It's currently waiting on more testing - my two tests have worked fine, and we've worked out the last bug in the migration instructions, as far as I know 00:50:06 Note that it uses the credentials from admin.stg.fedoraproject.org/accounts/, so if you changed your password recently, the data could be out of sync with the real FAS 00:50:21 There are two test repos setup - please test :-) 00:50:33 ricky: Oh yeah, I forgot that part. Everyone ignore my FAS statement :-) 00:50:41 ricky: What do you need people to test? 00:50:54 #link https://translate.stg.fedoraproject.org/ 00:51:12 Translators should probably check that their translation submissions work fine, and that the multi-POT support works as expected 00:51:30 If they don't find any failures, then we should be ready to move onto production 00:51:47 #info Needs more testing by Docs and L10n, specifically translators should check that submissions work; Docs people should test that multi-POT (Publican-style) support is working 00:51:58 Note that submissions are only enabled to the test repos 00:52:13 So refreshing stats on any other repos will most likely fail - that's expected 00:52:16 ricky: Is that just the two that are listed in the ticket? 00:52:27 The test repos are in https://translate.stg.fedoraproject.org/projects/p/publican/ 00:52:33 And one more thing that translators should be aware of 00:52:51 This release of transifex changes URLs - the /p/ in the above URL didn't use to be there 00:52:58 So just something to note 00:53:11 #info submissions are only enabled to the test repos at https://translate.stg.fedoraproject.org/projects/p/publican/ 00:53:23 #info note extra /p/ in that URL 00:54:13 ricky: The "localhost" repo is something anyone can push random crap to and it won't affect the actual Virtualization Guide repo on fedorahosted, right? 00:54:42 Yup - I should actually correct my statement again 00:54:49 submissions are only enabled to the localhost test repo, sorry :-) 00:54:57 Yes, just discovered that too 00:55:02 #undo 00:55:03 Removing item from minutes: 00:55:03 #undo 00:55:04 Removing item from minutes: 00:55:20 #info submissions are only enabled to the "virt-guide-localhost" test repo at https://translate.stg.fedoraproject.org/projects/p/publican/ 00:55:24 #info note extra /p/ in that URL 00:55:32 * jjmcd suspects that stickster must be an old HP calculator guy 00:55:37 heh 00:55:43 or forth programmer 00:55:45 rudi: This reminds me of something 00:56:13 rudi: There is a problem in ccurran's Virtualization_Guide repo, in that he's got both multi-POT format in the pot/ folder, and a standard single-POT in the po/ folder 00:56:36 rudi: He may have been maintaning that for compatibility reasons while Tx was broken 00:56:39 Let me see 00:56:56 It might also have to do with the choice of book... 00:56:59 But when Tx is fixed, that hack will break 00:57:09 Neither of the directories linked to were ever intended for Tx access 00:57:17 Aha 00:57:21 s/directories/branches 00:57:31 Well, as it turns out, if you get rid of the po/ file all works as expected 00:57:37 s/file/folder/ 00:58:45 OK, so specifically... rudi, will you check that behavior here on the staging instance is what you expect? 00:59:19 * stickster looking for action items so we can give Infra what they need to move this to production when the freeze ends, and get on with the biz 01:00:08 rudi: If you want to check a specific guide, make the request in the ticket and I'm sure ricky will be happy to add it to the Tx-staging instance. 01:00:39 stickster -- I'll check 01:00:53 #link https://fedorahosted.org/fedora-infrastructure/ticket/1455 01:01:02 And I confirm that the doubled-up PO files exist even in the branch intended for Tx access (f12-tx) 01:01:24 I'm sure it's just an oversight on my part (I handled the branching) 01:02:23 #action rudi to check on Tx staging behavior for one or more official guides and will report results to https://fedorahosted.org/fedora-infrastructure/ticket/1455 01:02:29 Anything else on this then? 01:02:41 First impressions are that it's right on the money! :) 01:02:47 yeah baby! 01:03:13 Shall we move on? 01:03:23 Ok 01:03:45 sparks: ready? 01:03:52 I am 01:03:54 Okay 01:04:09 #topic Making docs.fp.o accessible for non-JavaScript equipped browsers 01:04:20 Since rudi is here tonight... 01:04:42 I've always been here :) 01:04:49 Just muzzled :) 01:05:07 Last week we discussed an alternative to the JavaScript for docs.fp.o. 01:05:18 Yep; I'm good to take that 01:05:20 rudi: Can you make that page non-JS capable? 01:05:24 TU 01:05:35 moving on 01:05:40 NP 01:05:44 #topic Outstanding BZ Tickets 01:05:53 #link https://bugzilla.redhat.com/buglist.cgi?query_format=advanced&classification=Fedora&product=Fedora%20Documentation&bug_status=NEW&bug_status=ASSIGNED 01:06:04 rudi: There's a bug for that JS issue by the way 01:06:14 rudi: https://bugzilla.redhat.com/show_bug.cgi?id=544656 01:06:19 Thanks :) 01:06:23 np, hth 01:06:28 I'm still planning on planning a bug killing session on an upcoming weekend. 01:06:36 Any idea which weekend? 01:06:45 * stickster will set aside some time to help as long as he can plan for it 01:06:48 BUT, don't let that stop you from visiting the above link and starting today! 01:07:09 stickster: I don't. I haven't been able to get farther than the next day in my calendar. 01:07:42 sparks: Can we pencil something in now? I find that's very helpful in getting people to commit. 01:08:05 i.e. "Show up on X date" as opposed to "Let's do this someday" 01:08:20 How about March 6? 01:08:25 sparks: THAT IS WEIRD. 01:08:30 I was looking at the exact same weekend. 01:08:50 :) 01:09:13 Cool, shall we set aside, say, 10am-4pm EST as core hours? 01:09:36 WORKSFORME 01:09:49 Work can continue late if we have West Coasties, and/or we can add a late night session EST to catch anyone willing/able in BNE 01:09:56 jjmcd: Sound do-able? 01:10:04 quaid: ^^^ 01:10:12 Looks like one of the few weekends I CAN make it 01:10:16 awesome! 01:10:33 I'd have to check my calendar 01:11:01 #agreed Saturday March 6, 10am-4pm EST (1500-2100 UTC) for Docs bug stomping session! 01:11:02 * sparks marks his calendar appropriately 01:11:23 I like late night sessions 01:11:26 I think I can make it 01:11:57 #undo 01:11:58 Removing item from minutes: 01:12:01 * quaid reads up 01:12:02 #agreed Saturday March 6, 10am-4pm EST (1500-2100 UTC) for Docs bug stomping session in IRC Freenode #fedora-docs 01:12:20 #info core hours can be extended for extra participation 01:12:28 Ah I make a mistake. That is good too 01:12:32 * quaid is great with that weekend 01:12:34 That time is good 01:12:38 me too 01:13:01 WOOHOO! 01:13:32 sparks: Will you announce on Planet? 01:13:32 Okay, anything else on this? 01:13:54 #action sparks to announce the bug stomping session on Planet 01:13:58 w00t 01:14:33 * stickster is close to hard stop, fyi 01:14:37 Anything else on this? 01:14:46 nada 01:15:09 #topic Anything else? 01:15:18 Anything else anyone wants to talk about? 01:15:37 What if I need help with writing on the RN? 01:15:46 * jjmcd will be around 01:15:55 ok 01:16:12 joebebus: Feel free to pipe up on IRC #fedora-docs anytime 01:16:14 Ping me on #Fedora-docs 01:16:21 Ok 01:16:21 Yeah, exactly 01:16:37 I will be sure to do that if (when) I need help 01:16:37 joebebus: camping there is welcome, we can help you with that if needed 01:16:38 There are lots of people not typing there 01:17:05 or dm me on twitter if you have to :-) 01:17:10 ok 01:17:10 sparks: I'm really happy to see a new contributor here tonight. I'd like to see if we can ramp up a few people who've piped up on the list recently. 01:17:30 Yeah, I need to play some serious catch up on the list. 01:17:43 We seem to lose people right at the outset if we don't get them involved quickly with an easy social contact. 01:18:07 I have noticed that 01:18:12 My involvement with Fedora probably turned very specifically on my contact with quaid 01:18:24 Yeah, we need more folks looking over the list. If i'm heads-down on something, odds are sparks is too 01:19:01 The list is not very high traffic, so we can do a lot better with on-ramping 01:19:33 Okay, anything else? 01:19:36 It would also help if we had a nice queue of easy tasks somewhere that we could feed to people as they come on board 01:19:50 I second that 01:19:54 rudi: Yes. I proposed one to new entrant Eliot Smith this afternoon 01:19:57 Tsagadai suggested this some time ago, but we haven't managed to pull it off yet 01:20:13 rudi: It's as simple as marking bugs in our queue with EasyFix keyword. 01:20:22 True 01:20:24 That's an existing, well known keyword project wide 01:21:00 #info Use EasyFix keyword for easy BZ bugs for new people 01:21:03 I'm not sure what would be considered "easy" 01:21:26 You have to know how to interface with the guides and how to file a diff... 01:21:37 sparks: That information should be on the wiki page for each guide. 01:21:40 If it's not, that's a bug. 01:21:59 So the EasyFix can apply to: 01:22:08 1. Read the guide's Trac wiki page to check it out 01:22:12 2. Make the small fix needed 01:22:19 3. Read the guide's Trac wiki page to email your patch 01:22:22 done. 01:23:17 The things that happen in between 1 and 3 are where people may need mentoring, and that's natural and expected. We need to take advantage of that stage to be convivial, helpful, and grateful :-) 01:23:25 * stickster eof 01:23:36 I have to run guys 01:23:39 Thanks for the great meeting 01:23:54 Okay... anyone have anything else? 01:24:02 sparks, it was a really great meeting 01:24:12 it was :-) 01:24:24 Well, glad folks came out to make it great! 01:24:34 thanks everyone 01:24:37 #endmeeting