14:01:15 #startmeeting Docs Project Meeting - Agenda: https://fedoraproject.org/wiki/Docs_Project_meetings 14:01:15 Meeting started Mon Aug 29 14:01:15 2016 UTC. The chair is randomuser. Information about MeetBot at http://wiki.debian.org/MeetBot. 14:01:15 Useful Commands: #action #agreed #halp #info #idea #link #topic. 14:01:15 The meeting name has been set to 'docs_project_meeting_-_agenda:_https://fedoraproject.org/wiki/docs_project_meetings' 14:01:15 #meetingname Fedora Docs 14:01:16 The meeting name has been set to 'fedora_docs' 14:01:16 #topic Roll Call 14:01:54 * Capesteve waves 14:02:28 * pbokoc 14:02:34 /me ist hier 14:03:38 .hello bex 14:03:39 bexelbie: bex 'Brian (bex) Exelbierd' 14:04:07 hello everyone 14:04:19 #topic New Writers 14:04:35 Hi 14:04:40 in this part of the show, we take a moment to give new folks an opportunity to say hello or ask questions 14:04:47 hi, tkumar 14:04:57 hello randomuser 14:05:02 hey tkumar 14:05:02 How are you? 14:05:29 it's monday morning here, I'm not sure yet :/ 14:05:39 hehe 14:05:51 It's night over here :) 14:05:56 welcome to our meeting, do you have any docs questions? 14:06:57 Sure. I was going through guides. 14:07:25 If I remember it correctly, I have to put my name in front of a guide name 14:07:50 for guide lead or QA contact 14:07:55 right? 14:08:02 no, that's not really important 14:08:27 you don't need to list yourself as the lead writer or QA contact to work on a guide 14:10:04 Sure. I guess I will go over few guides and see if something needs updating or improvement. 14:10:26 Sure. You might pick up other ideas as the meeting continues as well. 14:10:51 Yes, I will. 14:11:01 #topic Where are with the Release Cycle and Docs? 14:11:16 we're behind schedule, actually 14:11:26 https://fedorapeople.org/groups/schedule/f-25/f-25-docs-tasks.html 14:12:04 there's not a lot on our list for alpha, but we should be ramping up to cover beats 14:12:39 Release notes work is tracked at https://fedoraproject.org/wiki/Category:Documentation_beats 14:13:22 putting your name on this one is more significant, since we're more likely to have multiple people working concurrently 14:13:45 if there's an asterisk, it means that person hasn't confirmed their participation 14:13:57 aaaand I still need to clean that up so it reflects current status 14:14:08 #action randomuser to update beats table 14:14:55 the disruptive stuff in f25 shold all be covered in https://fedoraproject.org/wiki/Releases/25/ChangeSet 14:15:37 with a bonus wayland as default for workstation that was done out of the change process 14:16:16 ... that's where we start, anyway. Thoughts? 14:16:50 I'll take some changes as usual and I'll talk to cspicer1 about collecting info on installer changes 14:16:53 do we know if any of these will also be written for the magazine/comm blog so we could ask those authors to help with Release Notes? 14:17:24 yeah, i expect the magazine folks will be doing their own documentation work 14:17:56 randomuser, cool - that way we can leverage that 14:18:05 anyone want to be our bridge to marketing and bring it up to them? 14:19:05 if not, I guess it will be me 14:19:15 I can mention it to jflory7 and send an email or two if you'd like 14:19:24 yes please, bexelbie 14:19:40 #action bexelbie to contact marketing/commblog about having article writers for new features do a release note too 14:20:26 I'd also like to represent SIGs better; if you're involved in one, please talk to them about release notes 14:21:30 any other thoughts? 14:21:35 * jflory7 reads 14:21:55 well this action item may be easy :P 14:22:11 jflory7, we can talk after this meeting if you'd like 14:22:22 bexelbie: Okay, sounds good, ping me whenever :) 14:23:31 #topic Specific Doc Status 14:24:03 I like the linguistic change away from 'guide' here bex, well played 14:24:12 * bexelbie bows :P 14:24:26 #info What has changed with specific docs? What needs to be republished? Any blockers or issues? 14:24:37 #info virt getting started guide probably needs to be republished 14:25:01 grundblom also fixed something in f24 release notes and was asking for them to be republished some time ago IIRC 14:25:15 hm, i'll check on that too 14:25:47 a month ago on docs@lists,fp.o, subject "Fixed release notes for Publishing" 14:25:55 * randomuser hangs head 14:26:32 hey that's nothing man, I promised to clean up beats and set them to Open like 2 months ago and I'm just doing it now :)) 14:26:41 heh 14:28:39 anything else you folks can think of we should do for the release cycle this week? 14:29:06 oh, actually, i've got one for you pbokoc 14:29:18 :I 14:29:49 you could write a readme for the install guide to explain your process when updating the guide 14:29:56 where to check, who to talk to, etc 14:30:21 oh yeah, that's probably a good idea 14:30:30 that would make it easier if you or cspicer don't have cycles to take care of it 14:30:42 yep 14:30:45 alright, I'll do that 14:31:02 i published the rn a while ago 14:31:30 the virt guide is waiting on author to fix the fedora release info etc. 14:31:39 there's a bug for that 14:31:41 pkovar++ 14:32:26 btw, I'll update the "beats closed" admonition in wiki so it links to pagure instead of cgit while I'm at it 14:32:40 nice 14:32:42 good find 14:33:31 pbokoc, https://pagure.io/install-guide/issue/4 14:35:10 huh, just discovered https://pagure.io/dpdk-guide 14:36:08 what other things should we discuss about specific docs that need work? 14:37:29 i'll throw this out: we're thinking of prototyping asciidoc stuff with the cookbook 14:37:46 so if folks come along that want to write standalone articles, they should be committed there 14:37:47 should we change topic to the "the new hotness?" 14:38:00 ha, sure 14:38:07 #topic The New Hotness 14:38:11 #chair bexelbie zodbot 14:38:11 Current chairs: bexelbie randomuser zodbot 14:38:15 #undo 14:38:15 Removing item from minutes: 14:38:19 #chair bexelbie zoglesby 14:38:19 Current chairs: bexelbie randomuser zodbot zoglesby 14:38:40 #info prototyping asciidoc stuff in the cookbook 14:39:09 i started doing some cleanup in a branch there, but didn't get super far on it 14:39:11 oh its that time of the week again. 14:39:23 I have a test build of the install guide in pintail - the biggest bug, I recall got fixed, but i want to try it on another guide 14:39:45 link for the lazy ones: https://pagure.io/fedora-cookbook/branch/asciidoc-master 14:39:59 #link https://fedorapeople.org/~bex/pintail/ 14:40:07 #info test build of Install Guide with bex mods using pintail 14:40:14 just for fun I wrote a little tutorial on setting up fedora as a hyperv guest, will push after polish 14:41:02 thanks pkovar 14:41:20 i do need some help with part of this, however 14:41:36 and zoglesby maybe you can answer this 14:41:52 how are we communicating the document metadata to pintail? 14:42:09 some kind of header or correlating file, right? 14:42:33 we are not yet. That is still a pending task on pintails side. May not be a ticket for it now that I think about it 14:42:37 why aren't we using the pintail.cfg? 14:43:31 aaah ok. I wasn't sure if the functionality was pending or just my knowledge of it 14:43:35 but yes, it will be yaml at the top of the doc 14:45:37 we spent a bunch of time on this last week, so I don't want to get too far into it this time 14:45:46 Do we have an MVP definition for the new system? 14:46:03 I don't know what that means, bexelbie 14:46:06 Are we just goaling for install guide from docbook and the cookbook from asciidoc styled and published? 14:46:25 MVP = minimum viable product - what is our definition of success so we can think about actually cutting over 14:46:31 in this case 14:46:49 I am concerned about theming and a style guide for our asciidoc 14:47:03 aaah.. we want to publish the guides we'd want to publish with publican 14:47:05 if we can get the install guide and cookbook working I would call it a success 14:47:34 so we are sure we are not going to drop any guides as part of this transition? 14:48:38 in general, we've been trying to separate content redesign efforts from tooling efforts 14:48:54 ok 14:49:10 i know that's somewhat counterintuitive, but the aim is to avoid circular dependencies 14:49:10 has anyone looked at the theming issues with pintail? 14:49:23 I am all for separating them 14:49:31 bexelbie: are you using the most recent version of docs-fp-o repo? 14:49:46 shaunm had done some theming and I don't see it in your example 14:49:48 zoglesby, depending on how recent it was updated, maybe 14:49:57 zoglesby, ok - then I'll need to pull and regen 14:51:53 have we heard from ryanlerch at all about site design? 14:52:05 no 14:52:12 i'm thinking that when he started things were perhaps a bit too raw for design work 14:52:38 wasn't there also an xml vs css issue? or am I thinking of something else? 14:53:02 that was a part of his issue, trying to get xslt to do what he wanted it to do 14:54:38 We're running low on time, let's get the bz link in the minutes and get to open floor 14:55:05 #topic Outstanding BZ Tickets 14:55:09 #info All Bugs - http://tinyurl.com/lbrq84 14:55:17 also, pagure issues 14:56:00 #info idle thought - some script or panel to aggregate pagure issues from all our projects into a single view would be neat 14:56:56 #topic Open Floor Discussion 14:57:42 I'll look at the api and see if I can make something work 14:58:08 zoglesby++ 14:58:09 randomuser: Karma for zoglesby changed to 5 (for the f24 release cycle): https://badges.fedoraproject.org/tags/cookie/any 14:59:31 well, if there's nothing else, I'll wrap it up 14:59:44 thanks for coming, everyone 14:59:50 #endmeeting