18:03:20 <randomuser> #startmeeting Fedora Docs Office Hours
18:03:20 <zodbot> Meeting started Thu Apr 30 18:03:20 2015 UTC.  The chair is randomuser. Information about MeetBot at http://wiki.debian.org/MeetBot.
18:03:20 <zodbot> Useful Commands: #action #agreed #halp #info #idea #link #topic.
18:03:34 <randomuser> awesome, smccann and grundblom are both here
18:04:10 <grundblom> Indeed!!
18:04:15 <grundblom> Hey everyone
18:06:19 <randomuser> ugh... this libxml "id already defined " business is ruining my day
18:06:19 <smccann> howdy!
18:10:56 <randomuser> your branch is looking good, smccann
18:11:00 <randomuser> does it build?
18:11:11 * randomuser has broken publican and can't tell
18:13:35 <randomuser> hm, grundblom's branch also does not build.
18:13:41 * randomuser goes to nag about the bug
18:15:07 <grundblom> strange!
18:15:38 <smccann> i haven't cloned myself but I thought it built yes
18:17:04 <randomuser> https://bugzilla.redhat.com/show_bug.cgi?id=1199396
18:17:12 <randomuser> early adoption tax :)
18:17:29 <randomuser> .fas veillard
18:17:33 <zodbot> randomuser: veillard 'Daniel Veillard' <veillard@redhat.com>
18:17:39 <randomuser> .fasinfo veillard
18:17:41 <zodbot> randomuser: User: veillard, Name: Daniel Veillard, email: veillard@redhat.com, Creation: 2005-10-13, IRC Nick: DV, Timezone: Asia/Shanghai, Locale: en, GPG key ID: DE95BC1F, Status: active
18:17:44 <zodbot> randomuser: Approved Groups: cla_done fedorabugs cla_fedora packager cla_redhat @cvslibvirt
18:21:22 <randomuser> anyway, if you both think your branches are sane, build properly, and look ok once built, we can get on with the merging
18:23:47 <smccann> yep
18:24:19 <grundblom> randomuser, I will test tonight and make sure it builds for me again, just to double check
18:24:28 <randomuser> fair enough
18:24:35 <randomuser> I'll do smccann's branch now
18:24:37 <grundblom> Should I email you directly, or to the list if it builds ok?
18:24:50 <randomuser> default to open :)
18:25:02 <grundblom> understood
18:25:36 <fedmsg-docs> 13trac.git.receive -- immanetize pushed some commits to the 'docs/virtualization-getting-started-guide' fedorahosted git repository 10http://da.gd/hZCw
18:31:17 <randomuser> .fasinfo smccann2
18:31:18 <zodbot> randomuser: User "smccann2" doesn't exist
18:31:22 <randomuser> bah
18:31:45 <randomuser> .fasinfo mccann2
18:31:46 <zodbot> randomuser: User: mccann2, Name: Sandra McCann, email: scmccann2000@gmail.com, Creation: 2014-11-03, IRC Nick: None, Timezone: UTC, Locale: en, GPG key ID: None, Status: active
18:31:49 <zodbot> randomuser: Approved Groups: docs-writers docs qa fedorabugs cla_fpca cla_done
18:32:48 <randomuser> smccann, I've sponsored you into docs-writers; you can check out the master branch and work in there now - with the virt getting started guide, or any guide
18:32:54 <randomuser> use your powers wisely :)
18:33:01 <smccann> eep!
18:33:07 <grundblom> Congrats!
18:33:12 <smccann> I HAVE THE POWER!!!!
18:33:47 <smccann> So are there directions somewhere on what I do differently now that I'm an official doc megalomaniac? :-)
18:34:33 <smccann> or is it everything the same except I have to learn how to do the merge step you are doing now?
18:35:06 <randomuser> smccann, it's the same pull, commit, push workflow - just leave out the fedorahosted repo part
18:35:24 <randomuser> err.. fedorapeople repo. You can commit directly to the fedorahosted repo
18:36:19 <randomuser> branches are optional - if you're doing something big, it's sometimes nice to create a branch and not worry about what's happening in master until you're finished - but if it's something small, you can commit directly to master
18:36:45 <randomuser> it's a judgment call - most of the time we don't bother with feature branches
18:37:07 <zoglesby> HI!
18:37:54 <randomuser> there are what I call 'release' branches - F20, F21, etc - those are published branches, which could merge commits or whatever
18:38:03 <randomuser> zoglesby, ! zoglesby !
18:38:48 <randomuser> where have you been!? I've missed you hanging around
18:39:34 <zoglesby> issues with son got worse, started a new job
18:39:47 <randomuser> :( , :)
18:40:21 <randomuser> still in the same neighborhood, I assume?
18:40:48 <zoglesby> yeah, office in DC, but I work from home a lot
18:40:53 <randomuser> awesome
18:41:03 <randomuser> can I overnight you a casserole or something?
18:41:08 <zoglesby> Almost my whole team is remote
18:42:04 * randomuser hopes you opt for "or something" - want to help if possible, but doesn't actually make edible casseroles
18:48:05 <zoglesby> randomuser: no worries, the ability to work from home has made all of this easier
18:52:53 <randomuser> zoglesby, I'm glad you were able to find something like that.
20:53:32 <grundblom> randomuser, are you still around?
20:53:48 <randomuser> grundblom, yeah, I'm here
20:54:24 <grundblom> I just tested my branch, it built fine with publican-fedora c 4, release 2.fc21
20:54:47 <randomuser> nice
20:55:03 <randomuser> you looked it over in the browser, and are satisfied with it?
20:57:00 <grundblom> Well, I have been looking at it via the help browser, and looking over the built PDF so far.
20:57:10 <grundblom> nothing is jumping out at me as needs fixed
20:57:43 * randomuser nods
20:57:48 <randomuser> yelp is handy
20:58:41 <randomuser> grundblom, did you test the connect too other computers thing?
20:59:04 <grundblom> randomuser, I tested out the vnc connection
20:59:33 <randomuser> cool, I didn't know it did vnc.  I was expecting only https://libvirt.org/uri.html stuff to work
20:59:52 <randomuser> ...we can add a bit on libvirt URIs later, maybe
21:00:02 <grundblom> Oh!
21:00:09 <grundblom> Wow, I didnt try any of that
21:00:27 <randomuser> yeah, libvirt can talk to just about anything
21:00:56 <grundblom> I did the VNC and attempted SPICE, but really only did VNC
21:01:16 <randomuser> I think unti recently spice was a virt-only thing
21:01:58 * randomuser just read about non-virt spice recently
21:02:56 <grundblom> I knew I forgot something
21:03:07 <randomuser> grundblom, well, I'll merge this so you can work in master, but still have a few comments
21:03:57 <randomuser> in some places you have 'files' refering to the abstract thing, and some places you have 'files' referring to the application, which should be <application>Files</application>
21:03:59 <grundblom> Oh, well if you think its not ready for prime time I will be happy to work on it more
21:04:17 * randomuser nods
21:04:59 <grundblom> Oh, hrm, ok I will have to look into that
21:05:46 <randomuser> just less confusing
21:05:57 <randomuser> anyway, give me a minute to merge this and sponsor your account
21:06:48 <grundblom> I think I see what you mean in 5.2 where I am trying to say how to make a new machine in boxes
21:07:40 <randomuser> I was reading the moving a virtual machine chapter, I think
21:08:53 <grundblom> Ah, yes I can see that,
21:09:04 <randomuser> oh, that might be better titled as "moving a boxes guest" or something similar, so it doesn't get people reading the toc mixed up about boxes vs other things
21:10:10 <grundblom> Maybe "How do I move a Boxes Virtual Machine between Computers?" to distinguish a VM made in boxes, vs a VNC or Spice connection
21:10:32 <randomuser> sure, something like that
21:12:17 <fedmsg-docs> 13trac.git.receive -- immanetize pushed some commits to the 'docs/virtualization-getting-started-guide' fedorahosted git repository 10http://da.gd/zAOm
21:14:33 <randomuser> .fasinfo grundblom
21:14:34 <zodbot> randomuser: User: grundblom, Name: None, email: glen@rundblom.com, Creation: 2015-01-19, IRC Nick: None, Timezone: None, Locale: None, GPG key ID: None, Status: active
21:14:37 <zodbot> randomuser: Approved Groups: docs-writers fedorabugs docs marketing cla_done cla_fpca
21:14:48 <randomuser> there you go, docs-writers
21:15:18 <randomuser> your changes are merged into the master branch of the fedorahosted repo; you can work there and not do the fedorapeople thing anymore
21:15:38 <grundblom> Oh Wow, Ok, will try not to mess things up
21:15:59 <randomuser> :)  I trust you to at least ask questions if you think you might :)
21:16:15 <randomuser> and git can be forgiving
21:17:02 <grundblom> Will do, I will change my git locations and refine the language in the next couple of nights
21:17:10 <grundblom> Can't wait for the semester to be over :-)
21:19:34 <randomuser> too bad sandra isn't still here, we could work out the plan for cleaning up the rest of the old content
21:20:34 * randomuser to the list!
21:20:58 <grundblom> Thats right, the list..
21:29:25 <randomuser> grundblom, so, the files thing - it's more of a language problem than a tag usage problem
21:29:47 <randomuser> take a word like... oh, 'block'
21:30:53 <randomuser> it could be a block device, or a storage block, or a city block, or a kid's building block or the action of blocking another action
21:31:14 <randomuser> you can totally figure out which one it is from the context
21:31:51 <randomuser> but in another language, there could be completely different words to represent each English connotation of 'block'
21:32:57 <randomuser> we add the tags, in part, to help the translators or tools understand the context
21:33:04 <grundblom> I get that, and I think I said ISO image as well, and that could be confusing, because, its an ISO file... I just think of it as in image
21:33:24 * randomuser nods
21:33:51 <grundblom> this is a frame of mind I did not have before
21:34:05 <randomuser> grundblom, ISO image is used in the installation guide (I did a guick grep) so I think you're good
21:34:33 <randomuser> it's used at least 17 times, in fact
21:34:58 <grundblom> so, ISO Image is a more understood term :-)
21:35:44 <randomuser> sure - and it's consistent with other documentation
21:41:59 <randomuser> grundblom, sometimes I get lazy or can't find a tag that fits just right and use <literal>block</literal>
21:42:40 <grundblom> Oh, that is handy,
21:44:59 <randomuser> haha, my plan worked!
21:45:14 <randomuser> hold a meeting long enough, and eventually ryanlerch will join your meeting!
21:45:32 <ryanlerch> haha
21:45:34 <ryanlerch> :)
21:46:38 * randomuser keeps the story about camping out in a conference room for a week to himself
22:00:08 <grundblom> gotta go
03:27:07 <randomuser> #chair Comic
03:27:07 <zodbot> Current chairs: Comic randomuser
03:27:15 <randomuser> bah
03:27:27 <randomuser> #chair gomix
03:27:27 <zodbot> Current chairs: Comic gomix randomuser
03:27:36 <randomuser> #endmeeting