14:05:17 <randomuser> #startmeeting Docs Project Meeting - Agenda: https://fedoraproject.org/wiki/Docs_Project_meetings 14:05:17 <zodbot> Meeting started Mon Nov 9 14:05:17 2015 UTC. The chair is randomuser. Information about MeetBot at http://wiki.debian.org/MeetBot. 14:05:17 <zodbot> Useful Commands: #action #agreed #halp #info #idea #link #topic. 14:05:19 <randomuser> #meetingname Fedora Docs 14:05:19 <zodbot> The meeting name has been set to 'fedora_docs' 14:05:20 <randomuser> #topic Roll Call 14:05:22 * randomuser kicks zodbot 14:05:49 <ryanlerch> .hello ryanlerch 14:05:50 <zodbot> ryanlerch: ryanlerch 'ryan lerch' <rlerch@redhat.com> 14:05:58 <randomuser> hello ryanlerch ! 14:06:00 * kirsti is in 14:06:06 <ryanlerch> hi randomuser! 14:06:11 <zoglesby> uggg, time change 14:06:14 <randomuser> thanks for staying up :) 14:06:20 <ryanlerch> randomuser: :) 14:06:22 * zoglesby is here 14:06:44 * d0nn1e is here 14:09:01 <randomuser> well, I guess we're all here 14:09:11 <randomuser> #topic Follow up on last week's action items 14:09:37 * randomuser finds notes 14:09:49 <randomuser> #info randomuser published a bunch of stuff 14:10:24 <randomuser> linux-modder was going to start looking at the security guide, which we'll discuss during the guide section if he is around 14:10:36 <randomuser> aaand, thats 14:10:42 <randomuser> pretty much it for action items 14:10:59 <randomuser> #topic New Writers 14:11:13 <randomuser> any new writers here, or reports of them? 14:11:44 * ryanlerch is kinda a new old writer :) 14:12:32 <zoglesby> ryanlerch: I don’t think most people where would remember you being active in docs 14:12:57 <ryanlerch> yeah, it was a long time ago :) 14:13:00 * randomuser assumes ryanlerch has done everything 14:14:09 <randomuser> how are you finding your reintroduction, ryanlerch ? Any questions or concerns? 14:15:10 <ryanlerch> not really -- just want to help to try to join docs and the magazine crew -- we are all writers for fedora, just dont really talk :) 14:15:14 * lnovich is here I forgot about the time change... 14:15:21 <ryanlerch> hi lnovich! 14:15:37 <lnovich> hello ryanlerch! 14:15:37 <ryanlerch> not *join*, more connect 14:16:09 * ryanlerch is not suggesting a merger between docs and the magazine :) 14:17:05 <randomuser> I think that the prevalence of technical content in the magazine demonstrates holes in the docs contribution model, but we don't have to get into that :P 14:17:20 <ryanlerch> also keen to jump in and help out in docs for the f24 cycle :) 14:18:19 <ryanlerch> but yeah, is that good enough for a re-introduction? 14:18:45 <randomuser> good enough :) 14:18:52 <ryanlerch> yay! 14:19:05 <randomuser> #topic Release Notes 14:19:10 <randomuser> we're done, hooray! 14:19:19 <randomuser> congrats to everyone on a successful F23 release 14:19:45 <randomuser> #action randomuser to reintroduce prerelease content into rawhide relnotes and push rpm 14:20:16 <randomuser> it takes about 15 minutes or so, let me know if you'd like to learn how and help maintain that package 14:21:44 <d0nn1e> randomuser, I'll be interested once you folks think I'm ready, but it's been a while since I've built an rpm from scratch. I can refresh my memory with my maximum rpm book 14:22:42 <ryanlerch> are the RPM's for pushing to the docs website? or for inclusion in the Fedora repos? 14:22:46 <randomuser> d0nn1e, sure, we can go through it together. 14:22:58 <randomuser> ryanlerch, nah, this is specifically the relnotes rpm, no others are packaged 14:22:58 * ryanlerch cant remember exactly how it works 14:23:13 <zoglesby> ryanlerch: the repo, we still use publican to build the website 14:23:20 <ryanlerch> ah, i remmeber now 14:23:22 <randomuser> there was a scheme for publishing everything via koji + rpms but it didn't really grow legs 14:23:29 <zoglesby> as it build it locally and git push 14:23:36 <ryanlerch> ah thats right 14:23:54 <ryanlerch> publican can build web rpms, that is what i was thinking of 14:24:03 <ryanlerch> sorry for sidetracking... 14:24:21 <randomuser> okay, not too much more we can say on release notes right now 14:24:34 <randomuser> #topic Publishing 14:24:52 <randomuser> I'm working on gathering up metadata and parsing it into different data structures 14:25:21 <randomuser> there's a JSON representation of the category structure and where articles fall within it right now 14:25:55 <randomuser> the next thing is to actually figure out what information should be presented to the visitor, and structure the data accordingly 14:26:58 <randomuser> I can think of a few ways; articles with similar tags, languages of an article, and so on - but I'm concerned that the result will be too heavy for effective browsing 14:27:28 <randomuser> ... as static content with client-side scripting 14:27:33 <randomuser> but we'll see, I guess 14:28:19 <ryanlerch> i was thinking that for an article, it might be good to have a field for <package> aslo -- this could be useful for linking from apps.fp.org/packages and other places too 14:28:34 * randomuser nods 14:28:52 <randomuser> I've been thinking a lot about custom restructuredtext things, ryanlerch 14:29:14 <randomuser> ie ":rhbz: 125864" linking to said bug 14:29:16 <ryanlerch> randomuser: i'm willing to help with some mockups for this 14:29:32 <randomuser> ryanlerch, I was really, really hoping you'd say that :) 14:29:40 <zoglesby> +1 14:29:42 <randomuser> how do we start ? 14:30:26 <ryanlerch> randomuser: that is going to be the tough part -- having some idea of content structure would be the first point to start at IMHO 14:30:45 <ryanlerch> actaully, not even structure -- more a list of article ideas 14:31:23 <randomuser> ryanlerch, I'll bullet point out some "what we know" stuff and put it up somewhere for you to read in the morning 14:31:25 <ryanlerch> from that, we could see the coverage, and build the idea of how to structure it 14:32:08 <ryanlerch> randomuser: if it helps, i spun up an etherpad the other day we used on for the release (to coordinate markerting stuff) 14:32:20 <ryanlerch> but it is still up if you need a scratchpad 14:32:41 <randomuser> I'd prefer some other way, etherpads are not very discoverable 14:33:04 <ryanlerch> yeah, i was more thinking for the inital dump of thoughts 14:33:16 <ryanlerch> anyway it seems that instance is down 14:33:35 * ryanlerch is a horrible sysadmin 14:33:39 <randomuser> heh 14:33:52 <randomuser> a github issue might do 14:34:05 <randomuser> keeps all the info in one place, anyway 14:34:53 <ryanlerch> is there a fedora docs github org? 14:35:01 <randomuser> but for whiteboarding... yeah, i can see a pad 14:35:10 <randomuser> ryanlerch, no, it's my personal 'anerist' project 14:35:26 <Southern_Gentlem> .hello jbwilla 14:35:27 <zodbot> Southern_Gentlem: Sorry, but you don't exist 14:35:29 <randomuser> we could set up an org, though 14:35:33 <randomuser> haha! 14:35:38 <Southern_Gentlem> .hello jbwillia 14:35:38 <zodbot> Southern_Gentlem: jbwillia 'Ben Williams' <vaioof@yahoo.com> 14:37:01 <ryanlerch> http://etherpad-rlerch.rhcloud.com/ 14:37:06 <randomuser> #action randomuser to prep some info for ryanlerch to start mockup conversation 14:37:20 <randomuser> #link http://etherpad-rlerch.rhcloud.com/p/anerist-mockup 14:37:47 <ryanlerch> that could go away at any time, so only use for whiteboarding, then move somewhere else :) 14:37:53 * randomuser nods 14:38:09 <ryanlerch> randomuser: there is always pagure.io too 14:38:11 <randomuser> this is a solid action item for this topic; anything else we should cover? 14:38:28 <randomuser> ryanlerch, yeah, it will go there eventually 14:38:41 * ryanlerch is working on making it prettier too :) 14:38:42 <randomuser> sooner if more people are participating 14:40:22 <randomuser> #topic Guide Status 14:41:20 <randomuser> Capesteve looked over the firewall guide and gave me some notes, which I should probably implement 14:41:27 <randomuser> stephenw++ 14:42:08 <randomuser> #action randomuser to apply capesteve's review to firewall guide 14:42:32 <randomuser> you may have noticed grubdblom has dug into our bz queue, which is awesome - it could be useful again! 14:43:12 <lnovich> go grubdblom! 14:44:05 <randomuser> if pbokoc was around I'd ask if we really want to keep doing the powershell checksum, but since he's not, that's all I have on guides 14:44:12 <randomuser> who else has guide news? 14:46:12 <zoglesby> is the powershell stuff broken again? 14:47:36 <randomuser> zoglesby, there's a new bug, apparently it doesn't work on some or all systems for ISOs > 2GB 14:48:21 <randomuser> also, while it's fun, it isn't the most straightforward or approachable method for getting a checksum 14:48:50 <randomuser> perhaps not worth the continued effort - I'm befuddled as to how array indexing keeps breaking 14:48:58 <zoglesby> well, its better than linking to a tool whos domain expired and is now trying to give people malware 14:50:00 <randomuser> true; I think one of the writing tools we *do* recommend has checksum functionality, though 14:51:43 <zoglesby> in what guide? I don’t see it in the install guide, and readme-burning-iso is out of date 14:52:12 <randomuser> the, err... suse writer thing 14:52:31 <zoglesby> yep, now I see it 14:55:20 <randomuser> well, enough on that 14:55:27 <randomuser> let's skip to open floor 14:55:36 <randomuser> #topic Open floor discussion 14:57:40 <randomuser> go ahead, speak your mind... 14:58:13 <lnovich> anyone in Cz thinking of going to or submitting a talk to devconf? 15:00:37 <randomuser> I don't think anyone from cz is here 15:00:58 <randomuser> and, we're at the end of the hour - I'm going to close early, as I have another thing in a couple minutes 15:01:06 <randomuser> #endmeeting