evergreen-docs:dig_meetings:20231207-agenda
Differences
This shows you the differences between two versions of the page.
Both sides previous revisionPrevious revisionNext revision | Previous revision | ||
evergreen-docs:dig_meetings:20231207-agenda [2024/01/03 14:49] – dluchenbill | evergreen-docs:dig_meetings:20231207-agenda [2024/01/03 17:26] (current) – dluchenbill | ||
---|---|---|---|
Line 1: | Line 1: | ||
- | ====== DIG Meeting Agenda - December 7, 2023 ====== | + | ====== DIG Meeting Agenda |
This meeting will be held via videoconference beginning at **2 p.m. EDT/11 a.m. PDT**. | This meeting will be held via videoconference beginning at **2 p.m. EDT/11 a.m. PDT**. | ||
Line 32: | Line 32: | ||
**// | **// | ||
- Introductions & Check-in | - Introductions & Check-in | ||
+ | - 9 people in attendance | ||
- Pet Show & Tell | - Pet Show & Tell | ||
+ | - 5 pets were in attendance (including a new black cat!) | ||
- Collaboration/ | - Collaboration/ | ||
- | - Hack-a-Way report | + | - Hack-a-Way report: Not much documentation stuff happened, other making the domain switch--then breaking the docs, briefly ;-) |
- | - Keyboard shortcuts documentation | + | - Andrea and Jane emptied queue of docs pull requests! Yay! Lots of first docs commits this year! |
- | - https:// | + | - Keyboard shortcuts documentation: https:// |
- | - Update Antora | + | - Sitka has added to their docs. Bunch of new stuff with Angular navigation plus the keyboard shortcuts. The latter are also context-specific (per last UI meeting). Also getting to keyboard shortcuts is different in AngularJS and Angular. |
- | - https:// | + | - Still need to get something into community docs in 2024, then continue to update as get rid of more AngularJS and Dojo pages. (We're getting closer and closer!) |
- | - Reports docs review | + | - |
- | - https:// | + | - Update Antora: |
- | - New for 2024: Angular Staff Catalog documentation | + | - On hold until people have time in 2024 |
- | - https:// | + | - Reports docs review: https:// |
- | - ? | + | - Susan did great review of reports docs! |
- | - Docs bugs (https:// | + | - Lena wrote documentation for Angular Reports! |
+ | - Awesome screen shots from Beth! | ||
+ | - Action item (but no shame): Andrea will tackle any newer updates | ||
+ | - New for 2024: Angular Staff Catalog documentation: https:// | ||
- Other Business | - Other Business | ||
- | - 2024: Technical writing student tackles Docs project(s)! (Report on 11/17 meeting) | + | - 2024: Technical writing student |
- | - Docs build errors? (ABN) | + | - Several of us met with Spencer |
- | - Next meeting: Thursday, January 4 - Works for everyone, so we'll leave it on this date | + | - He's going to work on the stuff in the "New for 2024" doc above |
+ | - Starting in January, finishing in March | ||
+ | - His Advisor loved it, especially tackling the project in stages | ||
+ | - Equinox may have community server updated to 3.12 in early 2024 | ||
+ | - Talked about new staff catalog features in 3.12 (not much--and Andrea already updated docs for " | ||
+ | - Docs build errors | ||
+ | - Hoping Blake or Jane would be present--not certain what's going on with build errors; weird stuff! | ||
+ | - New things not showing up in sidebar for previous versions, even though they' | ||
+ | - Git lesson from Andrea showing the things | ||
+ | - We were all confounded as to why they' | ||
+ | - Blake popped in: He'll take a look at it | ||
+ | - Blake discovered that the docs have been having trouble building since November 17--failing because it says it's running out of memory. Blake and Andrea will look into the date further to see if there was anything from around that date that could be causing it. | ||
+ | - Last docs commit before 11/16 was small one from Blake | ||
+ | - After that, next one was on 11/22 | ||
+ | - Could be running out of memory after updating Main, but before finishing 3.11, etc., since it does one branch at a time | ||
+ | - BLAKE' | ||
+ | - "that was the day that we added rel_3_12 branch to the list of branches we're asking it to generate. That was apparently one too many, and it has exceeded the 2GB memory limit that Node.js imposes itself. I've edited the generation script to allow for 4GB memory instead, and it finished! So, the website now has all of the latest stuff." | ||
+ | - "A secondary issue: the non-main branches were not getting the latest documentation. This was due to a flaw in the documentation script. It wasn't running through all of the branches and pulling the latest git changes. I've introduced a chunk of code in that bash script that does that now. | ||
+ | - Any system admins that need to know more: when a new branch is introduced, we're going to need to reference it in the build script ~antora/ | ||
+ | - Older Evergreen docs--missing 3.5. Antora docs go 3.6+ and older docs only go up to 3.4 | ||
+ | - It's there--we discovered a missing return carriage, which is why it's not showing up. Andrea can fix that (with " | ||
+ | - Next meeting: Thursday, January 4 | ||
+ | | ||
+ | - Conference things | ||
+ | - 3.12 docs scheduling |
evergreen-docs/dig_meetings/20231207-agenda.1704311358.txt.gz · Last modified: 2024/01/03 14:49 by dluchenbill