21:08:35 #startmeeting Documentation IRC meeting 22 February 2018 21:08:35 Meeting started Thu Feb 22 21:08:35 2018 UTC. The chair is LeeJ. Information about MeetBot at http://wiki.debian.org/MeetBot. 21:08:35 Useful Commands: #action #agreed #help #info #idea #link #topic #startvote. 21:08:35 The meeting name has been set to 'documentation_irc_meeting_22_february_2018' 21:08:36 leej I didn’t get the message ! That merge request was from awhile ago! 21:08:49 thanks! leej 21:09:04 kellym my pleasure! :) 21:09:16 #topic Introductions 21:09:16 #info wahanui, a bot that has become sentient 21:09:24 #info Katrin Fischer, BSZ Germany 21:09:27 #info Lee Jamison, Marywood University 21:09:27 #info Caroline Cyr La Rose, inLibro (Canada) 21:09:30 #info George Williams, Northeast Kansas Library System 21:09:35 #info Jonathan Druart 21:09:35 #info kelly mcelligott bywater solutions 21:09:41 #info Chris Cormack, Catalyst IT, NZ 21:09:58 # Michal Denar, KohaCZ 21:10:00 hi all and welcome to the meeting...again, sorry about the last one. That was on me :) 21:10:15 everyone present and accounted for? 21:10:23 cool 21:10:38 #topic What's been done so far 21:11:04 Joubu: I'm going to assume you may have news about the help files? 21:11:22 nope, I do not 21:11:36 okay 21:11:47 bug 19817 is in discussion 21:11:47 04Bug http://bugs.koha-community.org/bugzilla3/show_bug.cgi?id=19817 new feature, P5 - low, ---, jonathan.druart, In Discussion , Merge local and online documentations 21:11:49 does anyone have any updates, news, etc.? 21:12:02 I wanted to provide patches to have something ready for 18.05, but without feedbacks I cannot 21:12:39 #info Bug 19817 is still in discussion. Joubu wants to provide patches for 18.05 but needs feedback from the community to do so 21:13:36 #topic Workflows 21:14:10 okay..so it appears as though some/most who have a desire to help write documentation don't understand the gitlab workflow 21:14:33 so I'm prepared to offer a Zoom session/webinar to anyone interested in order to help 21:14:41 I'd be interested 21:14:42 LeeJ++ 21:14:44 leej i would say at one meeting awhile back it was talked about creating a vidoe about the process 21:14:58 yes I would be interested leej especially adding images to the manual 21:15:14 there is a video linked on the wiki page: edit manual? 21:15:17 editing manual? 21:15:23 editing the manual? 21:15:23 somebody said editing the manual was https://wiki.koha-community.org/wiki/Editing_the_Koha_Manual 21:15:43 kellym: yes I remember that meeting note. I had actually thought about it and realized it might be more effective having a recorded webinar to work from 21:16:21 definitely! yes there is a video on adding content but not adding images. I had problems with the steps on the wiki…so I would love a webinar leej 21:16:34 ah yep :) 21:16:40 I figured I'd take a page out of BWS' playbook :) 21:16:50 great idea! leej 21:16:52 kellym: what kind of images do you want to add? 21:16:56 leej++ 21:17:00 screenshots 21:17:00 screenshots are best 21:17:06 of Koha? 21:17:28 Seen my emails to the list about manual screenshots? 21:17:28 I haven't seen 'my', Joubu 21:17:29 yes screenshots of koha. it was also discussed to have images/screenshots of koha without customizations. 21:17:38 #info LeeJ will send out an email the week of February 26th to determine the best meeting time for a webinar 21:17:58 joubu I don’t remember seeing an email- can you send it to me? kelly@bywatersolutions.com 21:18:27 https://lists.katipo.co.nz/pipermail/koha/2018-January/049807.html 21:18:58 thanks joubu 21:18:58 thanks for bringing that up kellym! Joubu, do we have a written policy in place about using non-customized Koha for images/screenshots? I don't recall seeing one 21:19:06 what about screenshots in other languages in manual? 21:19:07 the idea was to provide a way to generate screenshot automatically 21:19:17 ahh 21:19:32 which would lead to autogenerated screenshots, updated from one version of Koha to another, and for any languages 21:19:45 m23_: same link 21:20:10 nobody reads my emails :-/ 21:20:10 LeeJ: we agreed on it at the last meeting 21:20:15 but i don't think we put it on the wiki 21:20:16 some languages are longer, other shorter .. how solve this in automatic way? 21:20:51 #info https://lists.katipo.co.nz/pipermail/koha/2018-January/049807.html contains information about the idea of automatically generating screenshots 21:20:59 cait: right..now it's coming back to me :) 21:21:09 we screenshot boxes (with class or id), so the sizes can vary 21:21:20 boxes == HTML elements 21:21:37 #info LeeJ will add the policy to the wiki of using non-customized Koha screenshots for documentation to keep documentation images uniform 21:21:42 LeeJ: do you want me to add a note on the wiki? 21:21:45 ah :) 21:21:46 even better 21:21:46 even better is what oleopard said just after that 21:22:17 It can work, I think 21:22:41 alright..I think that covers what I had in mind. I plan on also covering information on the kanban during the zoom webinar 21:22:42 leej do you think there should be something about standard size of images also? 21:22:54 how we can help with it? 21:22:57 m23_: it works 21:22:57 For now... 21:23:01 lol 21:23:41 kellym: that would make sense to me..however are there any cases (wide pages, etc.) where uniform image sizes would make the screenshot unreadable? 21:23:58 yes true- leej 21:24:41 Joubu and cait..what are your thoughts on requiring a uniform screenshot size? 21:24:50 maybe you should just read my emails 21:25:10 i am not sure - maybe only a max size? 21:25:11 there are examples for ar, en, es, it, pt_BR and zh_TW 21:25:19 for the first screenshots I generated automatically 21:25:30 * LeeJ feels sheepish 21:25:47 there are links to the different manuals at the end of the email 21:26:20 http://download.koha-community.org/manual/wip_screenshots/ar/html/02_administration.html 21:26:25 for instance 21:26:57 I see 21:27:01 Joubu, you should send emails to the general mailing list. I notice this one is the bugs mailing list? 21:27:22 it's the general mailing list 21:28:17 hmm 21:29:04 well I am willing to help with what I can per that mailing list email Joubu 21:29:38 I just realized I don't remember seeing it because I had my bugs list filtered to a folder 21:29:55 but let me know what you need me to do and I'll be more than happy to 21:30:38 has anyone mentioned the manuals are automatically updated now, as soon as changes are merged, it rebuilds all the languages 21:31:03 rangi: not that I can recollect..? But that's fantastic 21:31:17 for 18.05 and 17.11 21:31:23 https://koha-community.org/manual/18.05/zh_TW/html/ 21:31:30 https://koha-community.org/manual/18.05/en/html/ 21:31:32 etc 21:31:55 #info the manuals are automatically updated now since 18.05 and 17.11. As soon as changes are merged, it rebuilds all the languages 21:32:09 that's very convenient 21:32:22 anyone have anything else? :) 21:32:26 yeah it allows people to see if the changes they made look good 21:32:43 okay..moving on then 21:32:55 #topic Next steps 21:33:19 To summarize (please point out if I've missed something)... 21:33:52 uhh 21:34:01 what happened? 21:34:06 no clue.. 21:34:22 netsplit 21:34:44 ooh 21:34:56 irc apocalypse 21:34:56 I'll wait until people come back 21:35:05 ..if they do :O 21:35:40 don't you mean a splitpocalypse georgew? :) 21:36:16 back? 21:36:16 and forth. 21:36:23 pfiou 21:36:32 some never left it seems 21:36:55 that was weird..I've never been here for that. 21:36:59 rangi: What I said: but pootle is not updated 21:37:19 nope, that needs to be automated too 21:37:45 * cait waves 21:37:49 sorry got disconnected 21:38:17 _everybody_ got disconnected 21:39:08 so to summarize... Joubu needs help from the community to work on getting the documentation/help files/screenshots automated, etc. I'll be sending out an email next week to coordinate a webinar on kohadocs as well as I'll add our dediced policies about non-customized Koha to be used for all screenshots 21:39:13 did I miss anything? 21:39:53 LeeJ: for the automated screenshots: I need to know if what I suggest is a possible solution 21:40:15 i.e. does the syntax make sense for people without technical skills 21:41:35 #info read over the information at this link https://lists.katipo.co.nz/pipermail/koha/2018-January/049807.html and let Joubu know if what he suggests is a possible solution (i.e. does the syntax make sense for people without technical skills). Notify Joubu ASAP 21:41:46 it got lost in the netsplit 21:41:53 but what about the screenshots we can't generate? 21:42:06 pages that are not koha, enhanced content (needs keys etc) 21:42:27 let start with the ones we can generate :) 21:42:32 ok 21:42:35 What about new features? How do we say to add a screenshot for this or that if it isn't already in the manual? 21:43:02 caroline: that's definitely a topic I want to cover in the zoom webinar I'll be scheduling! 21:43:40 yes, but will they be automated? Is that something you will cover in the webinar? 21:44:07 #info also it's critical to provide feedback on Bug 19817 for Joubu 21:44:07 04Bug http://bugs.koha-community.org/bugzilla3/show_bug.cgi?id=19817 new feature, P5 - low, ---, jonathan.druart, In Discussion , Merge local and online documentations 21:44:26 I think that's something I might have to sort out with Joubu 21:45:21 caroline: I don't have an exact answer at the moment, but as soon as I do have an answer I'll relay it to everyone 21:45:43 okay...I think everything's been covered 21:46:05 ok, I was just mentionning it so we think about it, not to get an answer today 21:46:09 unless anyone has last minute additions? 21:46:29 caroline: I know :) and the input/reminder is appreciated! 21:46:56 :) 21:47:06 okay..since no one has anything further 21:47:16 #topic Set time of next meeting 21:49:06 alright..I think because the May release gaining on us quickly perhaps the 2nd week of March..any conflicting holidays? 21:49:33 may be good/bad during the hackfest? 21:49:44 do you know the dates of hackfest? 21:50:12 I wanna go to it next year :( 21:50:20 12 to 16 21:50:20 184884258895036416 21:50:32 hmm 21:51:02 then we can just schedule it for the week after hackfest 21:51:26 can be good during the hackfest :) 21:51:36 ooh good point 21:51:57 French tz is utc+2 21:52:08 haha you read my mind. I was JUST going to ask 21:52:27 CET is UTC+1 actually 21:52:34 i think the timing would be bad for the hackfest 21:53:09 people could learn about documentation related stuffs? 21:53:38 we could try, but depends on other presentations being during the same time or lunch :) 21:54:26 was there an itinerary sent out via email? 21:54:46 it's barcamp style 21:54:52 bit unpredictable until it happens 21:55:09 oooh 21:55:29 hmm..maybe we should just shoot for March 22nd? 21:55:39 gives people time to get home/recover from hackfest 21:56:30 March 22nd @ 14 UTC sound good? 21:56:56 works for me 21:57:10 it doesn’t work for me - but could you record leej? 21:57:33 kellym: the 22nd would be for the next documentation IRC meeting 21:57:40 the webinar will be separate :) 21:57:42 oh okay - that is fine 21:57:48 sounds good! 21:58:20 #info Next meeting: 22 March 2018, 14 UTC 21:58:38 #endmeeting