14:00:31 #startmeeting DIG Monthly Meeting Evergreen Documentation Interest Group (DIG) Monthly Meeting. 14:00:31 Meeting started Thu Apr 2 14:00:31 2015 US/Eastern. The chair is yboston. Information about MeetBot at http://wiki.debian.org/MeetBot. 14:00:31 Useful Commands: #action #agreed #help #info #idea #link #topic. 14:00:31 The meeting name has been set to 'dig_monthly_meeting_evergreen_documentation_interest_group__dig__monthly_meeting_' 14:00:40 The agenda can be found here http://evergreen-ils.org/dokuwiki/doku.php?id=evergreen-docs:dig_meeting_20150402-agenda 14:00:59 #topic Introductions 14:00:59 Please feel free to start introducing yourselves... 14:01:12 #info yboston is Yamil Suarez @ Berklee College of Music - DIG meeting facilitator 14:01:35 #info rsoulliere is Robert Soulliere, Mohawk College 14:02:11 info jihpringle is Jennifer Pringle, BC Libraries Cooperative (Sitka) 14:02:21 #info jihpringle is Jennifer Pringle, BC Libraries Cooperative (Sitka) 14:02:21 #info kmlussier is Kathy Lussier, MassLNC 14:03:47 welcome everyone 14:04:01 Robert or Kathy, do either of you have anything to report? 14:04:08 it is OK if you don't 14:04:15 I do 14:04:20 go ahea 14:04:26 *ahead 14:04:26 #topic Release Coordinator Report 14:04:50 #info I am adding acknowledgements plus one missing feature to the Release Notes as we meet 14:05:02 #info The 2.8 Release Notes should be complete by the end of today. 14:05:05 End of report 14:05:29 Oh, I do have something else. 14:05:48 BTW, Kathy do you have any doceumntation ont he process of making the release ntoes? 14:06:10 There has been some talk among the devs of possibly doing release notes for point releases. That's something I might like to consider doing if I have time for the 2.8 point releases. 14:06:24 [evergreen|Bill Erickson] 2.8 release notes creation and cleanup - 14:06:26 yboston: No, I don't have documentation. Is this documentation for devs who are writing release note entries? 14:06:35 Ha, nice timing berick 14:06:39 no, for the documentation side 14:06:45 in case you ever need a sub 14:07:07 or help 14:07:14 No, I don't have documentation because, as long as the devs do their release notes, I don't do much other than read them for clarity and add acknowledgements. 14:07:22 I do go through the ChangeLog to make sure everything is there. 14:07:27 OK 14:07:29 I can add something to the wiki, though. 14:07:33 I thought it was more involved 14:08:07 if you have the time, even a high level overview could be helpful 14:08:08 No, I think what the RM does is a little more involved. 14:08:18 yes, I agree 14:08:33 In terms of generating the Release Notes, that is. 14:08:49 Robert did you want to mention anything? 14:08:57 I have a couple of items. 14:09:01 go ahead 14:09:03 #topic Conversion Coordinator Report 14:09:09 #info Evergree Documentation for 2.8 is up and pulling for the rel_2_8 branch. 14:09:18 #link http://docs.evergreen-ils.org/2.8/ 14:09:27 rsoulliere++ 14:09:30 #info I have updated the 2_8 repository to include the 2.8 release notes. 14:09:58 rsoulliere++ 14:09:59 #info I have also added the 2.8 database schema documentation. 14:10:08 #info Links have been added to the documentaiton menu page: 14:10:13 #link http://docs.evergreen-ils.org/ 14:10:52 #questions any updates on the new doc servers? 14:11:31 I think the web group met yesterday 14:11:49 and they mentioned that they have an IP address and that thet need to still create the VM 14:12:03 kmlussier: where you at the meeting yesterday? 14:12:19 yes 14:12:35 am I remembering correctly that you know of? 14:12:43 Yes, that's what gmcharlt reported 14:13:01 kmlussier: thanks 14:13:12 I can follow up for next time to see what the progress is 14:13:26 #action yboston will check in on DIG VM 14:13:54 OK, sounds good. That is all I had for today. 14:14:05 thanks 14:14:16 I will move on to past meetign action items 14:14:40 #topic past meeting action items 14:14:47 #info 1 ) yboston will reach out to krvmga for another copy of his docs to push to master 14:15:00 I did not get a chance to do this, will defer for next time 14:15:22 #info 2 ) kmlussier will complete the marc stream importer work and check on the status of the RDA docs 14:15:43 kmlussier: any updates ont his? 14:15:52 I need to defer for next time. My plan is to create my own DIG day to work on my to-do list 14:16:02 OK 14:16:28 #action kmlussier will complete the marc stream importer work and check on the status of the RDA docs 14:17:05 the next two items were assigned to remingtron; but I am not sure if he is here? 14:17:19 will defer them for now 14:17:39 #action remingtron will send out email to list about cahnging the file suffix in the docs repo to .asciidoc 14:17:46 #action remingtron will send an email to the list to consider changing the AsciiDoc section header style 14:18:07 the next item was for the whole group 14:18:12 #info 5 ) all decide how to proceed with docs reorganization next meeting 14:18:30 this might be a good topic of discussion at the conference 14:18:55 #info remingtron is Remington Steed, Hekman Library (Calvin College) 14:18:59 (sorry so late) 14:19:02 hola 14:19:40 may I give a quick update on my two action items? 14:19:41 not sure if you have read what we have gone over so far 14:19:47 go right ahead 14:21:05 I have not initiated either of those conversations yet. I still plan to do the first, but not the second (header style syntax) since consensus was to allow individual choice, and I have come to agree 14:21:18 makes sense 14:21:59 that's all I wanted to say :) 14:22:20 not sure how to cancel one for the defered actions with meetbot, but I on't think it is a big deal 14:22:25 thank remingtron 14:23:15 so right before remingtron joined us I had just brought up the topic of "5 ) all decide how to proceed with docs reorganization next meeting" 14:23:39 I had also mentioned this might be a good topic for the upcoming conference 14:23:51 any comments or questiosn about the re-org goal? 14:24:13 #info remingtron will NOT send email to the list to consider changing AsciiDoc section header because the consensus was to allow individual choice. 14:24:17 For the minutes. :) 14:24:35 kmlussier++ 14:25:42 we can also defer the topic of the re-org for next meeting, if that is what we want to do as group today 14:25:43 I created a wiki page with some re-org ideas here: 14:25:46 #link http://evergreen-ils.org/dokuwiki/doku.php?id=evergreen-docs:reorg_2014:audience_focused_layout 14:26:24 It seems like the in-person meeting is a great opportunity to discuss something like a doc reorg. 14:26:31 I'd be glad for any input or reactions 14:26:52 and FYI, I'm not able to attend the conference this year 14:26:57 we need to plan to have a laptop to stream the meeting for those that cannot make it 14:27:02 so I'll do my best to participate remotely 14:27:10 yboston: thanks! 14:27:18 or a phone on speaker phone 14:27:21 (de nada) 14:27:57 remingtron: that links looks pretty good 14:28:05 *link 14:28:22 all are welcome to edit and expand that wiki page 14:29:08 should we stay ont his topic or move on? 14:29:45 the other two major topics arae web clients and EG 2.8 new feature docs 14:30:04 I'm happy to move on 14:30:47 good enough for me 14:31:12 #topic Progress on documenting new features in Evergreen 2.8 14:31:23 #link http://evergreen-ils.org/dokuwiki/doku.php?id=evergreen-docs:2.8_needs 14:32:09 I got about half-way through my assigned topics. 14:32:11 we still have a few features that need documenting. 14:32:24 I just realized I signed up for a second feature I need to document 14:32:50 I decided to do a new section regarding all billing OU settings, so it became a bigger project than I originally intended. 14:32:59 I see 14:33:13 that is what happens when adding new features :) 14:33:30 I also could document most of the items in the OPAC section, but I didn't want to sign up until I had finished my first two items. :) 14:33:52 some of those OPAC ones could be really simple, and great for a beguiner 14:33:55 Two of them are mine, so I feel a responsibility to document them. 14:34:09 yboston: Yes, I agree. I was thinking they would be good for a beginner too. 14:34:27 In some cases, it may just require checking to see if a screenshot needs to be replaced. 14:35:10 worse case scenario, we can use this low hanging fruit to give to newcomers at the conference. Though I am sure we would rather be done with 2.8 beofre the conference 14:36:38 also, thanks to I think remingtron for sending out reminders aout 2.8 new features ont he list 14:37:44 #action all finish outstanding EG 2.8 features listed here http://evergreen-ils.org/dokuwiki/doku.php?id=evergreen-docs:2.8_needs 14:38:06 should we switch to talking about web client docs? 14:39:00 I have one comment 14:39:09 (sorry, not paying close enough attention today!) 14:39:25 go ahead 14:40:25 I realized that any time we don't document a feature on a given version, it's hard to remember to go back and work on those. 14:40:34 :q 14:41:16 remingtron: I agree 14:41:18 I'd like to add a section at the bottom of the 2.8 docs needs wiki page called "From older versions" or such, which lists all outstanding docs features needing new docs 14:41:22 thoughts? 14:42:25 I think it would be helpful 14:43:01 sure, why not? 14:43:02 though some of it would have to be moved over when we do the 2.9 page, though I don't think that is a problem 14:43:42 okay, I'll work on that for 2.8 at least 14:44:03 should I make it an action item? 14:44:11 then DIG can use that list at the conference for any outstanding items 14:44:13 yboston: sure! 14:44:24 good idea 14:45:37 #action remingtron will add information of older outstanding doc needs to the 2.8 new feature doceumentation wiki page 14:46:27 any more questions/comments on EG 2.8 docs? 14:47:08 should we talk about the web client docs? 14:47:16 sure, onward 14:47:44 thanks again to remingtron for sending out an email to remind folks to help reivew some web cleint ocs that were submitted 14:47:52 we should make that an "all" action item 14:47:59 for next meeting 14:48:30 Yes, I was just thinking of those. You can give that action item to me if you want. 14:48:37 And I promise I will follow through on that one. :) 14:48:45 yboston: I'd put a higher priority on 2.8 docs, and suggest we wait on web client docs 14:49:09 remingtron: that makes sense; 14:49:36 we will have plenty of web client docs to work on at the conference 14:49:46 but if kmlussier wants an action item, I will not stand in her way! 14:50:06 I just want to review the ones we have. 14:50:19 #action kmlussier will review submitted web client docs to be included in repository 14:51:18 any other comments or questions on the topic of web client docs or anything else? 14:52:14 just the comment I added to the agenda 14:52:34 that we no longer need to wait before backporting web client docs to live docs versions 14:52:49 since ESI folks have published their remaining bugs on launchpad 14:52:55 We're backporting to 2.8 then? 14:53:25 yes, for as much is included in 2.8, and then 2.9 as more comes outs, etc. 14:54:23 though some have already been backported to 2.8 14:55:43 we are talking about doc commits? 14:56:00 yes 14:56:14 but are we keeping the seperate web client docs sections? 14:56:38 yes, still a "preview" version of the docs until the web client is more official 14:56:49 just makign sure 14:56:58 yboston: good clarification 14:57:06 thank you 14:57:16 we are almost at the hour mark 14:57:31 any other commetns or questions before we wrap up? 14:57:37 not from me 14:58:25 OK then, then I will wrap up 14:58:36 thank you everyone for attending 14:58:57 #endmeeting