| Time |
Nick |
Message |
| 06:00 |
pinesol |
News from qatests: Testing Success <http://testing.evergreen-ils.org/~live> |
| 06:42 |
|
Christineb joined #evergreen |
| 07:31 |
|
rjackson_isl_hom joined #evergreen |
| 08:20 |
|
rjackson_isl_hom joined #evergreen |
| 08:22 |
|
collum joined #evergreen |
| 08:44 |
|
Dyrcona joined #evergreen |
| 08:49 |
|
mantis joined #evergreen |
| 08:53 |
|
rfrasur joined #evergreen |
| 09:01 |
|
Keith-isl joined #evergreen |
| 09:11 |
|
jvwoolf joined #evergreen |
| 09:24 |
|
_collum joined #evergreen |
| 12:21 |
|
jihpringle joined #evergreen |
| 13:30 |
dluch |
Hi all! There is (maybe) a DIG meeting in 30 minutes. |
| 13:31 |
alynn26 |
It's on my schedule |
| 13:32 |
dluch |
For DIG folks...Between the holidays' vacation and then getting caught up on everything, I completely forgot to send out a reminder. Are you planning to be there today or should we cancel/reschedule? |
| 13:32 |
dluch |
Thanks, alynn26 |
| 13:34 |
jihpringle |
I have it on my calendar too |
| 13:45 |
Dyrcona |
Was anyone else aware that the Apache configuration files get copied to /openils/share/doc/ ? |
| 13:47 |
alynn26 |
No, but looking at ours, those are the default ones |
| 13:49 |
Dyrcona |
Yeah. It's another sign that we're doing autoconf wrong. :) |
| 14:00 |
dluch |
Well, since there are a few of us here, at least, I'm going to go ahead and |
| 14:00 |
dluch |
#startmeeting 2022-01-06 - Documentation Interest Group Meeting |
| 14:00 |
pinesol |
Meeting started Thu Jan 6 14:00:12 2022 US/Eastern. The chair is dluch. Information about MeetBot at http://wiki.debian.org/MeetBot. |
| 14:00 |
pinesol |
Useful Commands: #action #agreed #help #info #idea #link #topic #startvote. |
| 14:00 |
pinesol |
The meeting name has been set to '2022_01_06___documentation_interest_group_meeting' |
| 14:00 |
dluch |
#topic Agenda |
| 14:00 |
dluch |
#info The agenda can be found here: https://wiki.evergreen-ils.org/doku.php?id=evergreen-docs:dig_meetings:20220106-agenda |
| 14:00 |
alynn26 |
#info alynn26 is Lynn Floyd, Evergreen Indiana |
| 14:00 |
dluch |
Welcome everyone! Today's meeting will be business, followed by collaboration and working on documentation, if there's time. |
| 14:00 |
Bmagic |
#info Bmagic = Blake GH, MOBIUS |
| 14:00 |
dluch |
#topic Introductions |
| 14:00 |
dluch |
Please paste "#info <username> is <name>, <affiliation>" to identify who you are and what organization, if any, you represent. |
| 14:00 |
dluch |
#info dluch is Debbie Luchenbill, MOBIUS |
| 14:00 |
dbs |
#info dbs is Dan Scott, Laurentian |
| 14:01 |
jihpringle |
#info jihpringle is Jennifer Pringle, BC Libraries Cooperative (Sitka) |
| 14:01 |
abneiman |
#info abneiman is Andrea Buntz Neiman, Equinox |
| 14:01 |
jweston |
#info jweston is Jennifer Weston, Equinox |
| 14:03 |
dluch |
Thank you all for coming! My apologies again for not getting a meeting reminder out. If you come in later, feel free to introduce yourself when you arrive. |
| 14:03 |
dluch |
#topic Helpful Information: Documentation contributions and collaboration |
| 14:03 |
dluch |
#info You can find the Documentation Needs List at https://wiki.evergreen-ils.org/doku.php?id=evergreen-docs:documentation_needs |
| 14:03 |
dluch |
#info DIG Roles can be found at https://wiki.evergreen-ils.org/doku.php?id=evergreen-docs:digparticipants |
| 14:03 |
dluch |
#topic Old and Ongoing Business |
| 14:03 |
dluch |
#info Check-in - Happy New Year! How's everyone doing? |
| 14:04 |
alynn26 |
Doing good since everything has settled to a point after the upgrade. |
| 14:04 |
dluch |
alynn26 that's good! |
| 14:04 |
dbs |
Missing y'all |
| 14:05 |
alynn26 |
we miss you too, dbs |
| 14:05 |
* abneiman |
waves wildly at dbs |
| 14:05 |
abneiman |
and happy new year to all, we had a surprise snowstorm in MD so that was the highlight of my week |
| 14:06 |
dluch |
Oh, that's right! |
| 14:06 |
alynn26 |
abneiman, my brother lives near you, and his kids are loving it. |
| 14:06 |
abneiman |
alynn26: we're supposed to get more tonight! |
| 14:07 |
alynn26 |
we were supposed to get some here, but it split below and above us. |
| 14:07 |
dluch |
We were supposed to get (a tiny bit of) snow last night/this morning, but got nothin'. It all went south. To MD, apparently. :-D |
| 14:07 |
dbs |
❤❤ |
| 14:07 |
jweston |
yes, happy new year! surprise snow here in NC this week, too -- gone in a day (beautiful) -- maybe more tomorrow |
| 14:08 |
abowling |
Anyone have a solution for this off the top of their heads? ejabberd max_stanza_size = 2000000 and the MARC file in question is only 21KB, so I've ruled that out |
| 14:09 |
jihpringle |
well the snow hasn't been a surprise here, but we've had a bit more than usual - we've had about 6 feet since mid December and it's still snowing |
| 14:09 |
dluch |
abowling: We're having a DIG meeting right now, but I'm sure someone can help after! |
| 14:09 |
abowling |
dluch: oops sorry |
| 14:09 |
dluch |
DANG, jihpringle! |
| 14:09 |
jweston |
jihpringle wins the snow category! |
| 14:09 |
jihpringle |
we've got another 9 inches predicted tonight |
| 14:09 |
dluch |
abowling: no worries! |
| 14:10 |
dluch |
#info Previous Action Items |
| 14:10 |
dluch |
How are these coming? |
| 14:10 |
dluch |
I'll take them in order... |
| 14:11 |
dluch |
1. dluch and jweston will look at the wiki's Documentation Needs List (linked at the beginning) to ensure that undocumented features listed are still relevant in the 3.8 context. |
| 14:11 |
dluch |
I have still done nothing. I'm sorry, jweston! |
| 14:11 |
|
jihpringle joined #evergreen |
| 14:11 |
jweston |
so, jweston (talking in 3rd prson) has done nothing on her list -- sorry! this month looks promising |
| 14:12 |
dluch |
For me, too (I think)! |
| 14:12 |
dluch |
#action dluch and jweston will look at the wiki's Documentation Needs List (linked at the beginning) to ensure that undocumented features listed are still relevant in the 3.8 context. |
| 14:12 |
dluch |
2. dluch and jweston (and whoever else wants to) will see what documentation is missing from the Documentation Needs List for newest releases. |
| 14:13 |
dluch |
Also nothing here from me. |
| 14:13 |
jweston |
same |
| 14:13 |
dluch |
#action dluch and jweston (and whoever else wants to) will see what documentation is missing from the Documentation Needs List for newest releases. |
| 14:14 |
dluch |
3. alynn26 and Bmagic will investigate some possible options for adding pdf generating to our documentation site |
| 14:14 |
dluch |
Have you all had a chance to do this at all? |
| 14:14 |
alynn26 |
I did research some of the pdf generation, and there is a antora bug about it. |
| 14:15 |
alynn26 |
https://gitlab.com/antora/antora/-/issues/349 |
| 14:15 |
dluch |
I remember you saying that, actually. Was I supposed to remove that action item after last time, lol? |
| 14:15 |
Bmagic |
no progress from me on that |
| 14:16 |
alynn26 |
It is also in the road map for v 3.0 |
| 14:16 |
* dluch |
is super-with it today |
| 14:16 |
alynn26 |
It's ok, it just after the holidays |
| 14:16 |
dbs |
Hmm, Antora v3.0 was released just a few weeks back |
| 14:17 |
dluch |
Oh! I assume it wasn't included in 3.0, after all? |
| 14:18 |
dluch |
So, alynn26 and Bmagic, shall we keep the action item, or no? |
| 14:18 |
dbs |
looks like no - it's "Unstarted" for milestone 2: https://gitlab.com/antora/antora/-/milestones/21#tab-issues |
| 14:18 |
alynn26 |
Well, there is a gitlab plug in that will do it. |
| 14:19 |
Bmagic |
keep it. I'm seeing people out there making use of what code does exist. There is an antora-pdf extension |
| 14:19 |
dluch |
Alrighty... |
| 14:19 |
dluch |
#action alynn26 and Bmagic will investigate some possible options for adding pdf generating to our documentation site |
| 14:19 |
dluch |
4. alynn26 will look into Evergreen's Antora CSS to see why anything that is a heading 4 ==== or lower is not rendering properly formatted in Antora. Example: "Sort By Geographic Proximity" at https://docs.evergreen-ils.org/eg/docs/latest/opac/using_the_public_access_catalog.html#_viewing_a_record |
| 14:19 |
dluch |
alynn26, how's this going? |
| 14:19 |
Bmagic |
I suppose it begs the question: do we still need* a PDF of our docs? |
| 14:20 |
* alynn26 |
has not done that one. |
| 14:20 |
dluch |
Bmagic: yes, we do |
| 14:20 |
dluch |
#action alynn26 will look into Evergreen's Antora CSS to see why anything that is a heading 4 ==== or lower is not rendering properly formatted in Antora. Example: "Sort By Geographic Proximity" at https://docs.evergreen-ils.org/eg/docs/latest/opac/using_the_public_access_catalog.html#_viewing_a_record |
| 14:20 |
dluch |
5. dluch will get the October recording processed and posted. |
| 14:21 |
abneiman |
I am personally anti-PDF-for-Docs but it has been requested by some community members, so if there's a way to do it we should try to get that accomplished |
| 14:21 |
alynn26 |
pdf -- |
| 14:21 |
dluch |
Um...I don't think I did this, but don't remember |
| 14:21 |
dluch |
abneiman: Same |
| 14:22 |
dluch |
#action dluch will get the October recording processed and posted--unless she already did. |
| 14:22 |
Bmagic |
alynn26: The heading font sizes are controlled by our custom CSS repo https://git.evergreen-ils.org/?p=eg-antora.git;a=blob;f=src/css/doc.css;h=5ecfd53b6f6ce33c99a546d29888fa22ccf7dada;hb=HEAD |
| 14:23 |
alynn26 |
Bmagic, I know, the issue is it's not using them correctly I think . or something like that. It's may just be a simple edit needs done. |
| 14:24 |
dluch |
yup, that's it |
| 14:24 |
Bmagic |
dbs might make that absolete though :) |
| 14:24 |
dluch |
6. DIG (and anyone else) will review, comment on, and/or sign off on the patch for https://bugs.launchpad.net/evergreen/+bug/1944205 |
| 14:24 |
pinesol |
Launchpad bug 1944205 in Evergreen "Docs: Authority needs more advanced documentation" [Undecided,Confirmed] |
| 14:25 |
alynn26 |
I signed off on that one. |
| 14:25 |
dluch |
alynn26 signed off on the bug--does there need to be more done? |
| 14:25 |
dluch |
lol. Thank you, alynn26! |
| 14:25 |
abneiman |
I don't think so - I was going to review and push since alynn26 signed off |
| 14:25 |
abneiman |
alynn26++ |
| 14:25 |
dluch |
alynn26++ |
| 14:25 |
dluch |
abneiman++ |
| 14:26 |
dluch |
#info December Zoom Meeting--Recap and Decisions |
| 14:26 |
dluch |
We had a really nice social time, talked a lot about British mystery shows--and also discussed some docs organization stuff. |
| 14:26 |
abneiman |
(that is, once I remind my holiday brain how to do such a thing as "review and push" lol) |
| 14:27 |
dluch |
lol |
| 14:27 |
dluch |
Anyone else want to add anything about December's gathering? |
| 14:28 |
alynn26 |
I was an enjoyable time outside for me. |
| 14:28 |
abneiman |
we talked about Cowboy Bebop, too, and now I hope that the (currently rare & expensive) manga might be reprinted! |
| 14:28 |
jweston |
so sorry I missed it! |
| 14:28 |
dbs |
Bmagic: hmm, maybe? Headings look okay-ish at https://evergreen-library-system.gitlab.io/evergreen-library-system/docs/latest/opac/using_the_public_access_catalog.html |
| 14:28 |
jweston |
dluch: we skipped the last action item (#7) --- can you add that as another continuing action item? (oh, and jihpringle, I volunteered you for that one) |
| 14:29 |
dluch |
Oh, yes! I forgot about Cowboy Bebop! |
| 14:29 |
jihpringle |
jweston: happy to be volunteered :) |
| 14:29 |
dluch |
jweston: Sorry! Yes! |
| 14:29 |
dluch |
#action jweston will talk to jihpringle and mantis about the documentation an images review spreadsheets, create a Google doc for drafting a contribution guide, and send the link to the docs mailing list for everyone to help. |
| 14:30 |
dluch |
#info Docs organization: Progress |
| 14:30 |
dluch |
Seems like this should probably be punted to a future meeting. Anyone have something to discuss today? |
| 14:30 |
jweston |
+1 punting |
| 14:30 |
alynn26 |
+1 |
| 14:30 |
dluch |
cool |
| 14:30 |
abneiman |
+1 |
| 14:31 |
dluch |
That's all I have for old or ongoing business to discuss. Anything I missed that someone would like to talk about? |
| 14:31 |
dbs |
Is anyone interested in discussing GitLab Pages/CI or GitHub Actions (and/or Antora 3.0)? |
| 14:31 |
dluch |
#topic New Business |
| 14:31 |
dluch |
#info Docs auto-generating via Gitlab idea from dbs (http://list.evergreen-ils.org/pipermail/evergreen-general/2021-December/000929.html and thread). |
| 14:31 |
dluch |
lol |
| 14:31 |
Bmagic |
me |
| 14:31 |
alynn26 |
me |
| 14:32 |
dluch |
dbs: you want to lead off? |
| 14:32 |
dluch |
(I switched the order of new business items, btw) |
| 14:33 |
dbs |
So first up: correction to my most recent post. |
| 14:33 |
dbs |
You can download the full set of documentation from every commit / branch in GitLab Pages |
| 14:33 |
dbs |
(nothing needs to be figured out, other than my overtired brain) |
| 14:34 |
dbs |
Second: in 3.0 best practice is still to keep a separate git repo for the base Antora build stuff. So I would revert that |
| 14:36 |
dbs |
Third: working in GitLab or GitHub these days feels like lightyears ahead of CLI-based git workflows, given integrated issue tracking, project planning, Web IDE for drive-by contributions, merge request reviewing, etc |
| 14:36 |
|
bott_grpl joined #evergreen |
| 14:36 |
dbs |
but that one is way outside of the scope of "making it easier to build and test docs" and a much bigger discussion |
| 14:36 |
alynn26 |
I actually like working in GitHub better than the CLI. :) |
| 14:37 |
Bmagic |
do we need to migrate the Evergreen repository to a gitlab server in order to get this? We've talked about it as a replacement for Launchpad in a different dev discussion a couple of years ago (probably more because you have to skip the pandemic year(s)) |
| 14:37 |
abneiman |
I definitely prefer a GUI also, but I've gotten accustomed to operating within the CLI to the point where I'd need a github refresher to do the same work there |
| 14:38 |
alynn26 |
A better way to build and test docs that is more intuitive is better. |
| 14:39 |
dbs |
Bmagic: hmm - I'm mirroring the git repo on GitLab (have been since it was on gitorious like ten years ago). I don't think a mirrored branch triggers a GitLab CI/CD thing but I can check |
| 14:40 |
abneiman |
alynn26: hard agree about streamlining build/test of docs - it's a major roadblock right now |
| 14:40 |
dbs |
it might be possible to trigger a rebuild using something like a particular branch name, like docs-build or something hacky... make that a to-do for me |
| 14:41 |
dluch |
Sure |
| 14:41 |
Dyrcona |
FWIW, we run gitlab at CW MARS mainly just to try it out. We don't do any fancy CI/CD stuff though. |
| 14:41 |
Bmagic |
Having our about-to-be submitted docs reviewed and integrated into the Evergreen Docs look and feel would be super tasty. The routine would be to submit your test changes to a certain pre-defined Git branch, and poof, a minute later, it's rendered on a page somewhere |
| 14:41 |
dbs |
alynn26 abneiman: even the small win of "can't merge this because you introduced an error" with a clear error message in the branch discussion is so nice |
| 14:42 |
dluch |
#action dbs will see if it's possible to trigger a rebuild using something like a particular branch name, like docs-build or something hacky |
| 14:42 |
alynn26 |
Clear error messages would be a win for me. |
| 14:42 |
dbs |
:) |
| 14:43 |
abneiman |
dbs++ |
| 14:43 |
Bmagic |
dbs++ # indeed |
| 14:43 |
dluch |
dbs++ |
| 14:43 |
Bmagic |
dbs: antora rocks? right? |
| 14:44 |
dbs |
awww, you're all so sweet 😢 |
| 14:45 |
alynn26 |
dbs++ |
| 14:46 |
jweston |
stepped away and just reading up, this sounds promising! |
| 14:46 |
jweston |
dbs++ |
| 14:47 |
dluch |
Anything else about this that we need to talk about today? |
| 14:49 |
dluch |
#info February Zoom Meeting--Show and Tell Topic? |
| 14:49 |
dluch |
Any requests/volunteers/thoughts about February's topic? |
| 14:50 |
jweston |
if there isn't anything more technical, how about looking at the doc/images review spreadsheets to jumpstart that initiative? |
| 14:50 |
dluch |
jweston: that sounds like a good idea |
| 14:50 |
abneiman |
+1, good call jweston |
| 14:51 |
jweston |
oops -- only I can't make Feb mtg (schedule conflict) -- but hey, I'll support the planning! |
| 14:51 |
dluch |
lol |
| 14:52 |
dluch |
#agreed The February Zoom meeting will be looking together at the docs and images review spreadsheets |
| 14:53 |
dluch |
Is there any other new business we need to discuss? |
| 14:54 |
dluch |
We are very close to time, so I'm going to call it. But feel free to collaborate! :-) |
| 14:54 |
dluch |
#info Our next meeting will be on February 3, on Zoom. I'll post the link on the agenda about a week prior to the meeting. |
| 14:54 |
jweston |
dluch++ |
| 14:54 |
alynn26 |
Looks good for me. |
| 14:54 |
alynn26 |
dluch++ |
| 14:54 |
dluch |
Thanks for being here, everyone! |
| 14:54 |
dluch |
#endmeeting |
| 14:54 |
pinesol |
Meeting ended Thu Jan 6 14:54:46 2022 US/Eastern. Information about MeetBot at http://wiki.debian.org/MeetBot . (v 0.1.4) |
| 14:54 |
pinesol |
Minutes: http://evergreen-ils.org/meetings/evergreen/2022/evergreen.2022-01-06-14.00.html |
| 14:54 |
pinesol |
Minutes (text): http://evergreen-ils.org/meetings/evergreen/2022/evergreen.2022-01-06-14.00.txt |
| 14:54 |
pinesol |
Log: http://evergreen-ils.org/meetings/evergreen/2022/evergreen.2022-01-06-14.00.log.html |
| 14:54 |
abneiman |
dluch++ |
| 14:55 |
jihpringle |
dluch++ |
| 14:55 |
dbs |
My #action is done, the answer is "yes" (no hacks needed, other than to wait for the mirror to happen): https://docs.gitlab.com/ee/ci/ci_cd_for_external_repos/ |
| 14:55 |
dluch |
Awesome! dbs++ |
| 14:56 |
Bmagic |
dbs: c'mon, you're making the rest of us look bad |
| 14:56 |
alynn26 |
very bad |
| 14:57 |
alynn26 |
I think that is one of the reason we miss you. |
| 14:57 |
dluch |
:-D |
| 14:57 |
dbs |
Just need to spend some time figuring out the best way to make it work with the eg-antora and eg repos |
| 14:57 |
dbs |
:-P |
| 14:58 |
dbs |
alynn26: my prowess at DuckDuckGo searches? lol |
| 14:58 |
alynn26 |
that how I always find the pdf bug in Antora. |
| 14:59 |
dbs |
alynn26++ |
| 15:00 |
alynn26 |
DuckDuckGo++ |
| 15:02 |
|
collum joined #evergreen |
| 15:03 |
Bmagic |
dluch++ |
| 15:04 |
dbs |
dluch++ # indeed |
| 15:11 |
|
Keith_isl joined #evergreen |
| 15:51 |
|
_collum joined #evergreen |
| 15:59 |
|
mantis joined #evergreen |
| 16:14 |
|
jihpringle joined #evergreen |
| 18:00 |
pinesol |
News from qatests: Testing Success <http://testing.evergreen-ils.org/~live> |
