14:00:08 #startmeeting 2020-09-03 - Documentation Interest Group Meeting 14:00:08 Meeting started Thu Sep 3 14:00:08 2020 US/Eastern. The chair is dluch. Information about MeetBot at http://wiki.debian.org/MeetBot. 14:00:08 Useful Commands: #action #agreed #help #info #idea #link #topic #startvote. 14:00:08 The meeting name has been set to '2020_09_03___documentation_interest_group_meeting' 14:00:22 #topic Agenda 14:00:42 #info The agenda can be found here: https://wiki.evergreen-ils.org/doku.php?id=evergreen-docs:dig_meetings:20200903-agenda 14:00:46 Welcome everyone! Today's meeting will be business, followed by collaboration and working on documentation, if there's time. 14:00:58 #topic Introductions 14:01:08 Please paste "#info is , " to identify who you are and what organization, if any, you represent. 14:01:08 #info dluch is Debbie Luchenbill, MOBIUS 14:01:11 dluch: sorry to barge in, but I do have one update that's relevant but can't otherwise join the meeting - I will be merging the Antora branches definitely, tomorrow 14:01:31 Awesome, thank you, gmcharlt! 14:01:50 #info jihpringle is Jennifer Pringle, BC Libraries Cooperative (Sitka) 14:01:54 #info kgmartin is Katie Greenleaf Martin, Blair Co Lib Sys in Central PA 14:01:55 #info abneiman = Andrea Buntz Neiman, Equinox 14:01:59 gmcharlt++ 14:02:11 gmcharlt++ # Antora FTW 14:02:24 #info rfrasur = Ruth Frasur, Evergreen Indiana et al 14:02:35 #info Bmagic = Blake GH, MOBIUS 14:04:03 Thank you all for coming! If you come in later, feel free to introduce yourself when you arrive. 14:04:07 #topic Helpful Information: Documentation contributions and collaboration 14:04:18 #info You can find the Documentation Needs List at https://wiki.evergreen-ils.org/doku.php?id=evergreen-docs:documentation_needs 14:04:18 #info DIG Roles can be found at https://wiki.evergreen-ils.org/doku.php?id=evergreen-docs:digparticipants 14:04:30 #topic Old and Ongoing Business 14:04:47 #info Check-in - How is everyone doing? 14:04:47 How are things where you are? 14:05:25 Cray cray, but okay 14:05:27 We're still working from home, and our COVID numbers have gone through the roof since the college kids came back to town. 14:05:57 dluch: I'm also in a college town and I am so grateful they opted for all-remote for the fall 14:06:29 as for me, the humidity is revolting here but otherwise we're mostly OK 14:06:49 abneiman: that IS good. I haven't paid attention to the news this week, but last week the MU pres. said they weren't going to close because young people get over it quickly. *eyeroll 14:07:30 Apparently the MU pres never missed two weeks of school and then tried to catch up while also living the "college experience." 14:07:47 "college students will totally responsibly socially distance" - people who have made careers out of working with college students, apparently 14:07:49 I hear ya on the humidity. We were originally supposed to get some relief from it this weekend, but now it's been pushed to middle of next week. fingers crossed 14:07:59 Lol. Exaclty 14:09:05 jihpringle: how are things up where you are? Do you all get affected by all the Pacific coast area fires? 14:10:01 we've been pretty lucky as far as fires this year, though we did have a thunderstorm with lightning that set off 5 fires on the mountains around me 14:10:19 Yikes! 14:10:19 a couple smokey days but nothing compared to the last few summers 14:10:45 That's good. You have had some rough summers, for sure 14:11:01 most of the fires were very far from any people or buildings so there was a lot of monitoring and waiting for rain to put them out 14:11:31 I'm going to move on. But am not at all opposed to continued personal conversations. :-) 14:11:34 #info Previous Action Items 14:11:49 How are we doing on these? Has anyone had time for anything? 14:11:49 I'll take them in order... 14:12:14 #1 sandbergja will make a video for proof of concept in the Quick Starts section 14:12:26 I don't think sandbergja is here 14:12:29 ? 14:12:34 oh I just got here! 14:12:55 Oh, yay! Greetings! 14:13:02 Can you defer that until next time? 14:13:07 Absolutely! 14:13:11 #action sandbergja will make a video for proof of concept in the Quick Starts section 14:13:28 #2 Bmagic is writing a script to identify places in Antora docs that need headers raised up a level. DIG will help with making the changes then. 14:13:28 Bmagic? 14:14:07 I'll be honest, though a full 30 days has gone by, I've not done anything for DIG. This line item, however, was done a couple of months ago 14:14:40 Okay, cool. So are we at the place for DIG to make changes, or do we need to wait on some more to be done? 14:14:54 And thanks! bmagic++ 14:15:12 The dev meeting did mention gmcharlt merging the antora branch. I've not seen that come through 14:15:21 Bmagic: scroll up 14:15:26 :) 14:15:27 He said earlier he's doing it tomorrow 14:15:29 lol 14:15:35 ty 14:15:52 and related to said, once Antora is merged, I have several docs commits lined up :) 14:16:02 Okay, I'm going to remove that action item, then. 14:16:09 abneiman: awesome!! 14:16:15 abneiman++ 14:16:32 #3 dluch will update the style guide to reflect new header stuff 14:16:42 I completely forgot about this again. Will keep it. 14:16:55 #action dluch will update the style guide to reflect new header stuff 14:17:11 #4 We will revisit the topic "#info Should the server-side generation script(s) be in the EG repo?" when scripts are done 14:17:11 Are scripts done? 14:17:38 yep 14:17:46 that was also completed prior to last meeting 14:18:01 Well, last meeting was working, so we didn't cover any of these things 14:18:59 Okay, so " Should the server-side generation script(s) be in the EG repo?" Or is that done, too? 14:20:53 Bueller? 14:21:36 yep 14:21:41 that is done, committed to the branch 14:21:55 Awesome. Bmagic++ 14:22:04 I'll remove that action 14:22:07 #5 dluch will start working on an Antora roadmap, with help from Bmagic and remingtron, that we can share with devs and others 14:22:27 It seems like this is a moot point now? (And since we never got around to it at all--sorry!) 14:22:52 agreed that it seems moot since gmcharlt is preparing to merge it 14:23:32 Great. Will remove the action 14:23:44 #6 dluch will send a message to the docs list to ask for video documentation contributions to the community YouTube channel 14:23:53 Lol, in my notes I have [SERIOUSLY, DO THIS BEFORE THE NEXT MEETING.] 14:23:59 But I didn't 14:24:24 #action dluch will send a message to the docs list to ask for video documentation contributions to the community YouTube channel 14:24:46 #info Antora progress 14:25:06 As noted above, gmcharlt is merging Antora docs tomorrow! Yay!!! 14:25:12 gmcharlt++ 14:25:39 gmcharlt++ 14:25:46 Anything else in Antora-land that we should talk about today? Or just wait until next time when it's all done? 14:26:40 are there any other changes to the style guide or instructions pages that are needed? 14:26:44 w/r/t Antroa 14:26:49 or even Antora 14:27:21 Hmm. I don't know. When I update the style guide with the header stuff, I will check 14:28:02 dluch++ 14:28:03 (It will probably be next week, but I'm putting on my planner this time) 14:28:35 #info Launchpad documentation cleanup 14:28:43 During our collaboration time during the last meeting, we made a start at doing this. Has anyone had time in-between? 14:28:52 abneiman: What is the procedure for these? If we find something, should people notify you? Is there a way to contact the bug wranglers in general? Or is removing tags and stuff something anyone can do? 14:29:30 I think anyone can add/remove tags 14:29:57 Excellent 14:30:14 abneiman++ 14:30:47 I know I looked at it a bit after last meeting, and that's the last time I thought about it 14:30:59 and absent a way to ping the Bug Wranglers in general, people can reach out to me if they have questions - either here in IRC or via email 14:31:17 abneiman++ 14:31:54 #info 3.5/Experimental Catalog documentation 14:32:05 I know jihpringle and maybe some others were working on these and/or contributing them. Any news? 14:32:56 I'm plugging away at them in our docs and happy for anyone to take what I've done so far and strip out anything Sitka specific for teh community docs 14:32:58 http://docs.libraries.coop/sitka/_experimental_catalogue.html 14:33:15 Thank you! 14:33:18 jihpringle++ 14:33:46 Any other old or ongoing business to discuss? 14:34:06 it should be possible to pull the asciidoc files from our repository or I can always email the files to someone if that's easier 14:34:40 Awesome, thank you for all your work! 14:34:58 Okay, moving on... 14:35:07 #topic New Business 14:35:10 #info From CWG organizing committee: annual "DIG for Catalogers" training 14:35:22 The CWG organizing committee is doing future planning and suggests having an annual "DIG for Catalogers" training like we did this year. 14:35:22 Thoughts? Volunteers? 14:35:54 jweston couldn't be here today, but says they have no particular date in mind and she's happy to help plan again 14:36:31 It went really well this year, and it seems like a good idea 14:37:15 I think it's a great idea and could possibly help (depending on when it is) 14:37:36 Awesome, thanks jihpringle! 14:38:09 I also plan to help again 14:39:17 Okay, well, I'll let jweston know, and the three of us can figure out a good date/time. It doesn't have to be during the normal CWG meeting, so lots of flexibility 14:39:28 jihpringle++ 14:39:31 jweston++ 14:39:34 sounds good :) 14:39:50 Is there any other new business we need to discuss? 14:41:01 Okay, we have about 20 minutes left... 14:41:06 are we planning to have a docs hackaway or something around the release of 3.6? 14:41:29 It looks like quite a bit of new stuff is going to make it into 3.6 14:41:42 I was assuming we would, as part of the onlie hackaway in October 14:42:04 The EG Hackway (Oct. 26-28)could definitely accommodate a DIG component. 14:42:28 rfrasur++ 14:42:42 Does that work for folks? 14:43:13 jihpringle: confirming that this is your repo? http://git.sitka.bclibraries.ca/gitweb/ if so, I can look at some of the angular catalog docs (during hackaway, probably not before) 14:43:21 (It's my first Hackaway, and I'm excited!) 14:43:55 abneiman: that's our old one 14:43:57 https://github.com/BCLibCoop/sitka-manual 14:44:06 As we get further along in the planning for that online event, we may need some more information about what DIG would like to do so we can configure rooms to meet those needs, but it shouldn't be any big deal at all. 14:44:10 jihpringle++ I thought some of those "last change" dates looked a little stale :) 14:44:22 a quick note that docs have traditionally been a part of the hack-a-way and unless there aren't folks doing it will continue to be 14:44:32 rfrasur: Sounds good, thanks 14:44:36 rhamby++ 14:45:12 #action DIG will participate in the fall Hackaway and particularly focus on 3.6 docs 14:45:27 dluch et al., noting that re 3.6 features, Equinox stuff will all have accompanying docs merged once I finalize them 14:45:45 abneiman++ 14:45:56 abneiman++ 14:46:09 Any other new business? 14:46:51 Okay, we have about 15 minutes left... 14:47:07 #topic Collaboration time 14:47:16 What is everyone planning to work on today? Please let us know here, and feel free to talk and work with each other. If you'd like extra accountability, I can make an action item to show up in the minutes, but it's not necessary 14:47:35 Also, for the last meeting, I made a list of ideas you can work on (alone or with others) if you don't already have something. I know it can be kind of overwhelming sometimes to know where to start. 14:47:35 -your own priority projects 14:47:35 -finishing 3.5 docs 14:47:35 -experimental catalog docs 14:47:36 -cleaning up old docs tickets on Launchpad 14:47:36 -finding docs tickets on Launchpad to work on 14:47:38 -easy tasks from Documentation Needs List 14:47:40 -auditing and removing finished or irrelevant items from the Documentation Needs List and/or adding 3.5 documentation needs 14:47:42 -still-relevant items from the Documentation Needs List (be sure to assign yourself to it so we don't duplicate work) 14:47:45 -documentation-related short videos for the community YouTube channel 14:47:47 -looking through existing docs for things that need updating - text and/or images 14:48:54 belatedly - I did have an item of new biz (apologies) - and it is that Outreach is going to be reviewing wiki pages for outdated info. I know that the DIG stuff is pretty well maintained, so this shouldn't affect its pages, but just as an FYI 14:49:28 abneiman++ Thanks 14:49:50 Still can't hurt to look through and see what we might no need anymore 14:49:56 *not 14:50:09 akilsdonk has signed up to review most of the docs pages 14:50:23 Great! 14:50:28 akilsdonk++ 14:50:50 And I'm happy to help if she has any questions or anything 14:51:13 dluch++ 14:52:11 sandbergja: I was going to drop a note on LP 1642023 saying that you & I had reviewed it during BSW and that I'm willing to signoff/commit if Lynn is finished with that (I don't see her in channel atm) 14:52:12 Launchpad bug 1642023 in Evergreen "Docs: Web Client Print / Receipt Templates" [Medium,Triaged] https://launchpad.net/bugs/1642023 - Assigned to Lynn Floyd (lfloyd) 14:59:38 We are at time. 14:59:38 Next meeting will be October 1. Same bat time, same bat channel. It will be primarily collaboration time. 14:59:52 Thanks for coming, everyone! 15:00:03 dluch++ # lots of progress. Thanks. 15:00:07 dluch++ 15:00:12 #endmeeting