fedora_docs
LOGS
14:03:18 <bexelbie> #startmeeting Fedora Docs
14:03:18 <zodbot> Meeting started Mon Jul  3 14:03:18 2017 UTC.  The chair is bexelbie. Information about MeetBot at http://wiki.debian.org/MeetBot.
14:03:18 <zodbot> Useful Commands: #action #agreed #halp #info #idea #link #topic.
14:03:18 <zodbot> The meeting name has been set to 'fedora_docs'
14:03:30 <bexelbie> It is a holiday week/set of days for many places - anyone around/
14:04:15 <pbokoc> I kinda am
14:04:21 <bexelbie> hola
14:04:27 <bexelbie> Any news, good or not?
14:04:31 <bexelbie> pbokoc, ^
14:04:44 <x3mboy> Hi o/
14:04:50 <bexelbie> Hi
14:04:52 <bexelbie> .hello bex
14:04:53 <zodbot> bexelbie: bex 'Brian (bex) Exelbierd' <bex@pobox.com>
14:05:01 <x3mboy> .hello2 x3mboy
14:05:02 <zodbot> x3mboy: x3mboy 'Eduard Lucena' <eduardlucena@gmail.com>
14:05:03 <pbokoc> randomuser seems to have successfully pushed the f26 relnotes package, so we're good on that end
14:05:11 <bexelbie> cool
14:05:14 <bexelbie> I suspect we have more updates to make
14:05:16 <pbokoc> https://bodhi.fedoraproject.org/updates/FEDORA-2017-adb4811783
14:05:24 <bexelbie> I really want to explore the idea of moving to just a pointer in the package
14:05:30 <bexelbie> but that is a not this week thing
14:05:36 <shaunm> .hello shaunm
14:05:37 <zodbot> shaunm: shaunm 'Shaun McCance' <shaunm@gnome.org>
14:05:45 <pbokoc> yeah, it's just a dummy book that says "go check the website"
14:06:02 <bexelbie> pbokoc, ahh, couldn't tell from IRC traffic if he had pushed content or not
14:06:21 <pbokoc> we didn't have enough content to warrant anything else, and people were asking for a package ASAP
14:06:51 <pbokoc> so anyway, that means we have time till the 11th to write relnotes
14:07:02 <pbokoc> well, 10th, we should be ready the day before I guess
14:07:03 <bexelbie> 11th? go/no go is on the 6th
14:07:11 * bexelbie goes to read a calendar
14:07:25 <pbokoc> well, yeah, 11th is the current GA date, it might slip again
14:07:36 <kk4ewt> .hello jbwillia
14:07:37 <zodbot> kk4ewt: jbwillia 'Ben Williams' <vaioof@gmail.com>
14:07:46 <bexelbie> pbokoc, ahh, yes - sorry mind is on slow speed
14:07:55 <kk4ewt> actually it should be done so it can be in the rc
14:08:09 <pbokoc> and docs don't (usually) matter for go/nogo meetings
14:08:12 <bexelbie> #topic Release Notes
14:08:29 <bexelbie> pbokoc, they should and I believe jkurik would like them too
14:08:45 * bexelbie was hoping randomuser would be here so I could tag out on attending go/no-go
14:08:57 <bexelbie> terminal isn't around either ...
14:09:14 <pbokoc> let's not go there, the usual pre-release circus with the relnotes package is enough attention already :)
14:09:21 <bexelbie> hahaha
14:10:09 <pbokoc> anyway, we still have some unassigned relnotes; https://pagure.io/release-notes/issues
14:10:40 <pbokoc> instructions are on the mailing list as well as in each issue's original description, if anyone has any questions, go ahead and ping me
14:10:48 <bexelbie> Some of the change owners are putting in stub text - so please consider taking a release note if you're willing to encode what is there and validate it
14:10:54 <bexelbie> pbokoc++
14:10:55 <zodbot> bexelbie: Karma for pbokoc changed to 2 (for the f25 release cycle):  https://badges.fedoraproject.org/tags/cookie/any
14:12:08 <bexelbie> It sounds like we have most of a plan, is there anything else on the topic of release notes?
14:12:40 <pbokoc> that's all I've got
14:13:23 <bexelbie> #topic open floor
14:13:32 <bexelbie> I am abbreviating the meeting due to attendance because of holidays
14:13:36 <bexelbie> anything pressing for this week?
14:14:01 <x3mboy> Hi, this is my first meeting
14:14:04 <pbokoc> well, we should figure out what other guides we can publish other than relnotes
14:14:18 <bexelbie> x3mboy, howdy - sorry you're catching a weird one because of holidays
14:14:30 <pbokoc> install guide should be fine, when I write the relnotes section on the installer I'll make changes in the guide too
14:14:42 <bexelbie> pbokoc, I was hoping that randomuser could weigh in on the publishing aspect of that
14:14:45 <x3mboy> bexelbie, no problem
14:14:53 <x3mboy> So, nice to meet you guys, Hope I can help in next release.
14:15:03 <bexelbie> pbokoc, sounds like that the goals should be install guide, sysadmin guide and release notes based on various side conversations I have had
14:15:05 <pbokoc> x3mboy, welcome :)
14:15:27 <pbokoc> bexelbie, yeah, that's what I'd consider a sort of a base set
14:15:49 <bexelbie> pbokoc, let's assume those then
14:15:58 <pbokoc> the sysadmin guide could probably use some updates at this point, I don't think anyone's worked on that for a while
14:16:09 <bexelbie> I am working on a skunk works project to push us out the door in AsciiDoc - and by work I mean leveraging lots of other people's work and tieing it together
14:16:12 <pbokoc> but that's probably not going to happen this week, so I wouldn't worry about it too much
14:16:18 <bexelbie> pbokoc, exactly re: updates
14:16:39 <bexelbie> Without terminal though, I don't have any guarantees yet - he is working on a docbook->asciidoc conversion
14:16:39 <x3mboy> My only question is: Is there an introductory guide or something? I dig a little bit in the wiki and I didn't found anything
14:17:03 <bexelbie> Eduard - do you want to walk through it in person in Peru?
14:17:30 <x3mboy> bexelbie, sure!
14:17:51 <pbokoc> weeeeeeell
14:17:53 <bexelbie> x3mboy, that may be easiest in this case - but I would suggest you start by looking at the syadmin guide? pbokoc ?
14:18:23 <pbokoc> regarding the conversion tool, we actually have something that works pretty alright in RH, and I don't think we'd have a problem with sharing that
14:18:41 <bexelbie> pbokoc, that is the one terminal is using :)
14:18:46 <bexelbie> it was published by clayton
14:18:48 <pbokoc> ah
14:19:00 <bexelbie> he is mostly doing the heavy lifting required after it runs
14:19:09 <pbokoc> right, well, still, we have an internal fork that has additional fixes (plus a few open issues that still need to be fixed)
14:19:22 <pbokoc> so we're kinda duplicating effort here
14:20:01 <pbokoc> about what to start with: yeah, I suppose the sysadmin guide would be a good start. On the other hand, that guide 1) still uses docbook, and if x3mboy doesn't know it, I don't think it's worth learning if we're about to migrate away from it anyway
14:20:05 <pbokoc> it's not exactly easy to get into
14:20:14 <bexelbie> https://pagure.io/fedora-docs/asciidocs-sysadmin is the current start on converting that guide
14:20:22 <bexelbie> not an ideal location . but what we have today
14:20:28 <pbokoc> and also, we really could use a sort of an intro guide for newcomers
14:20:49 <bexelbie> I know - it'd be nice to resolve the intro guide once we had tooling worked out - I think we are close, really.
14:20:58 <pbokoc> sort of a "I'm trying this Linux thing for the 1st time, how do I play a movie/unpack a RAR/format a USB drive"
14:21:10 <bexelbie> oh, that kind of intro guide :P
14:21:55 <pbokoc> OTOH, Fedora isn't really targeting complete newbies, there are other distros better suited for that, so I don't know how useful that would be
14:22:35 <x3mboy> pbokoc, bexelbie Do you check the "User Guide" that Ambassadors are working on?
14:22:55 <x3mboy> https://pagure.io/ambassadors/fedora-handbook/
14:23:07 <pbokoc> huh, never heard of that
14:23:14 <x3mboy> I'm translating that one to Spanish, maybe you can check
14:23:27 <x3mboy> Help was requested to check/improve 5th chapter
14:23:32 <bexelbie> ahh, this one
14:23:38 * bexelbie would love to see that using Zanata
14:23:53 * x3mboy too!!!!
14:25:01 <bexelbie> let's put that on our conversation list
14:25:58 <bexelbie> sounds like you have something, even if not in the formal docs set to keep busy with for now x3mboy
14:26:03 <bexelbie> and I know that has value to the project
14:26:13 <pbokoc> x3mboy, by the way, have you used git before?
14:26:17 <bexelbie> we can worry about finding out if we want to publish it with docs down the road
14:26:55 <x3mboy> pbokoc, yes, but no too much, just some basics (clone, pull, push, PR)
14:27:35 <pbokoc> x3mboy, cool, that should be enough, we don't generally do any deep sorcery here :)
14:27:57 <x3mboy> pbokoc, cool!
14:29:55 <bexelbie> x3mboy, pbokoc any other questions re: next steps for x3mboy ?
14:30:14 <pbokoc> well, you could grab a release note or two :)
14:30:29 <pbokoc> that's the top priority at the moment
14:31:56 <x3mboy> pbokoc, well, let me check and I can take something, right now, precisely because the next release, I'm a little busy with Marketing, but I can take some time to read and help in what I can
14:32:57 <pbokoc> x3mboy, no pressure. Just make sure that if you do assign something to yourself, and you find yourself unable to finish before the 10th (day before release), you let me or someone know so we can handle it instead
14:33:32 <x3mboy> pbokoc, ok, good.
14:33:36 <pbokoc> I mean, theoretically we can do a post-release update, but we'd rather avoid that since our publishing workflow is... painful
14:33:38 <x3mboy> Thanks for the welcome!
14:34:41 <bexelbie> Any other open floor topics?
14:35:31 <bexelbie> closing in 60 seconds
14:36:05 <bexelbie> closing in 30 seconds
14:36:25 <bexelbie> closing in 10 seconds
14:36:32 <bexelbie> 5
14:36:34 <bexelbie> 4
14:36:35 <bexelbie> 3
14:36:37 <bexelbie> 2
14:36:39 <bexelbie> 1
14:36:41 <bexelbie> Thank you all
14:36:45 <bexelbie> #endmeeting