14:01:33 <yboston> #startmeeting 2013-12-05 - DIG Monthly Meeting Evergreen Documentation Interest Group (DIG) Monthly Meeting.
14:01:33 <pinesol_green> Meeting started Thu Dec  5 14:01:33 2013 US/Eastern.  The chair is yboston. Information about MeetBot at http://wiki.debian.org/MeetBot.
14:01:33 <pinesol_green> Useful Commands: #action #agreed #help #info #idea #link #topic.
14:01:33 <pinesol_green> The meeting name has been set to '2013_12_05___dig_monthly_meeting_evergreen_documentation_interest_group__dig__monthly_meeting_'
14:01:42 <yboston> The agenda can be found here http://evergreen-ils.org/dokuwiki/doku.php?id=evergreen-docs:dig_meeting_20131205-agenda
14:01:51 <yboston> #topic Introductions
14:01:51 <yboston> Please feel free to start introducing yourselves...
14:02:04 <kmlussier> #info kmlussier is Kathy Lussier, MassLNC
14:02:07 * yboston is Yamil Suarez @ Berklee college of Music - DIG meeting facilitator
14:02:12 * rsoulliere is Robert Soulliere, Mohawk College
14:02:32 <kbutler> /me is Kate Butler, Rodgers Memorial
14:02:34 <kbutler> bah
14:03:01 * hbrennan is Holly Brennan, Homer Public Library, AK
14:05:15 <yboston> Lets move on, late comers can introduce themselves as they arrive
14:05:16 <hbrennan> (I'm sorta here and sorta not.. as I run away now to get in the mail)
14:05:36 <yboston> #topic Updates from Content Coordinators
14:05:44 <yboston> (if there is anything to report)
14:05:51 <rsoulliere> I can go first.
14:05:59 <rsoulliere> #topic Conversion Coordinator Report
14:05:59 <yboston> go ahead rsoulliere
14:06:05 <rsoulliere> #info EG 2.5 documentation is now being processed on the documentation web server.
14:06:17 <rsoulliere> #info I shared some information and tools with yboston regarding processing documentation from the repositories. Here are some of the tools in a repository I set up a long time ago:
14:06:31 <rsoulliere> #link https://github.com/rsoulliere/Evergreen_Documentation_Tools
14:06:42 <rsoulliere> #info If anyone else is interested in setting up their own documentation site for testing or experimenting and needs some technical assistance to get started, let me know.
14:06:56 <rsoulliere> That is all.
14:07:03 <yboston> rsoulliere++
14:07:35 <kmlussier> I can go next.
14:07:38 <yboston> rsoulliere: I have a comment for you
14:07:43 <kmlussier> But I'll wait. :)
14:07:57 <yboston> there is still content that was worked on during the hack-a-way
14:08:21 <yboston> some of it is large, any suggestions of how to minimize problems that break the nightly build
14:08:44 <yboston> should we send you the files beforehand? should we load them up on a different server?
14:09:26 <yboston> should we through a bunch on a particular day that you pick to be looking over at the errors we get?
14:09:40 <rsoulliere> yboston: For most issues the included page with the error should only be the one to break.
14:09:45 <yboston> I don't want to cause the nightly builds to be broken for several days
14:10:26 <rsoulliere> Typos etc... shouldn't bring the whole documentation site to a crash.
14:10:46 <yboston> rsoulliere: I guess we can start with a few as see how it goes. So far I just waited until the next day to see if the one page was built successfully.
14:11:02 <rsoulliere> I would test locally using the basic ascidoc command and upload if it passes the test.
14:11:20 <rsoulliere> I probably would load a bit at a time as you suggest.
14:11:40 <yboston> any particular combination of parameters?
14:11:48 <rsoulliere> If you notice anything not appearing, let me know via email and I can troubleshoot on the server.
14:12:05 <yboston> also, I had issues with the bash source highlighting on OS X, was not sure how to fix
14:13:08 <rsoulliere> yboston re: parameters: I think the basic html conversion should be a good test. That should catch most syntax issues.
14:13:22 <yboston> rsoulliere: OK
14:13:49 <rsoulliere> re OSX highlighting: do you mean display issues in safari?
14:14:29 <yboston> no, that when I tried to build all of the docs, the asciidoc command line utility said it did
14:14:43 <yboston> not know how to format/highlight bash source
14:14:50 <yboston> I have to dig up the error
14:15:42 <rsoulliere> Oh,  processing on OSX?
14:16:23 <rsoulliere> Let me know the error and I can help in troubleshooting.
14:17:13 <yboston> asciidoc: WARNING: RELEASE_NOTES_2_5.txt: line 163: filter non-zero exit code: source-highlight -f xhtml -s bash: returned
14:17:14 <yboston> asciidoc: WARNING: RELEASE_NOTES_2_5.txt: line 163: no output from filter: source-highlight -f xhtml -s bash
14:17:18 <yboston> (found it)
14:17:29 <rsoulliere> Via email I mean after the meeting;-).
14:17:48 <yboston> I just wanted to give you a peak :)
14:17:57 <yboston> any other comments on my question or for Robert?
14:19:23 <kmlussier> None here.
14:19:33 <yboston> Kathy, go ahead with your report or comments
14:19:38 <kmlussier> #topic Release Coordinator Report
14:20:01 <kmlussier> #info We have the 2.5 doc needs identified at http://evergreen-ils.org/dokuwiki/doku.php?id=evergreen-docs:2.5_needs.
14:20:25 <kmlussier> #info Anyone who wants to help document new features can add their name to the wiki to let people know what they're working on.
14:20:56 <kmlussier> #info I also created some draft guidelines for submitting doc needs to LP that I also shared with the list. http://evergreen-ils.org/dokuwiki/doku.php?id=evergreen-docs:lp_docs
14:21:28 <kmlussier> #info If anyone has any suggestions for improvement, let me know. Or feel free to edit the wiki page.
14:21:31 <kmlussier> That is all.
14:21:57 <yboston> kmlussier++
14:22:28 <yboston> any comments or questions for Kathy?
14:23:48 <yboston> kmlussier: did you want to ask the conference related question now on IRC or I can do it by email?
14:24:29 <kmlussier> yboston: Actually, I'm mulling things over a bit. Can I get back to you via e-mail on that?
14:24:34 <yboston> OK
14:24:54 <yboston> we can move on
14:25:11 <yboston> ...new business
14:25:30 <yboston> #topic Post DIG hack-a-way discussion
14:26:00 <yboston> Here is a copy of my hack-a-way recap...
14:26:03 <yboston> #link http://georgialibraries.markmail.org/thread/k5ccpllzfhtb44b5
14:26:25 <yboston> I probably forgot to give credit to someone, but no one has corrected me yet
14:26:53 <yboston> Any comments or questions?
14:27:58 <yboston> My elevator speech about the hack-a-way, it was great for getting new folks trained on DIG workflows and asciidoc. It was hard to find small taks for volunteers to work on
14:28:17 <kbutler> yboston: Thank you for hosting. I thought it was productive.
14:28:28 <yboston> we still have files that were worked on that need to be pushed to the repository
14:28:38 <yboston> kbutler: thanks
14:29:54 <yboston> I hope by January all of the work that was started (and finished) at the hack-a-way has been integrated to the docs.
14:30:47 <yboston> I also hope that it iwllbe easier to find tasks to give to newcomers not that we have a video tutorial to get more people u to speed
14:30:56 <yboston> (now that we have)
14:32:02 <yboston> Also, at the next conference, we should have a whole day to work on docs. Hope that we can apply other lesson of this hack-a-way to that hackfest
14:32:24 <yboston> BTW< thanks to ESI, that was the test server we ended up using the most
14:33:31 <yboston> Any comments or questions?
14:35:19 <kmlussier> Sounds like you all got a lot accomplished. Nice work!
14:35:33 <kmlussier> yboston++ for pulling it together.
14:36:34 <yboston> Next year I plan to again offer to host, but perhaps we can all decide meet somewhere else in Massachusetts
14:37:46 <kmlussier> I know a couple of places that might be willing to host. :)
14:38:42 <yboston> Looks like today it is a day that we wrap the meeting early, since I don't have much else to cover
14:39:06 <yboston> but let me know if we want to cover something else before we wrap up
14:41:14 <kmlussier> Unfortunately, I'm only partially here today and can't contribute much, so I'm in favor of wrapping up.
14:41:21 <yboston> One quick thing,
14:41:39 <yboston> I was contacted by a representative of "Asciidoctor | An open source implementation of AsciiDoc in Ruby"
14:41:48 <yboston> #link http://asciidoctor.org/
14:42:02 <yboston> Asking i few had ever considered switching to it.
14:42:09 <yboston> Just wanted to throw that out there
14:43:15 <yboston> we can wrap up unless someone has something to say
14:43:19 <yboston> or ask
14:44:28 <yboston> OK folks, thanks
14:44:45 <yboston> #endmeeting