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