2021-03-16 Tech Docs Meeting notes

Date

Mar 16, 2021

Time	Item	Notes

Time	Item	Notes
10 mins	updates	static site generators (Blake) Docs for Nginx and multi-tenant implementations (with Docker) (also Blake) tech-docs/provisioning/clustering.md at master · archivesspace/tech-docs Tech docs ideas from user group archives (mostly via Rachel): https://docs.google.com/spreadsheets/d/1YODEHVfjvn_1agmgK00FjdZ8-o3bO2D3knsrDvO3zfI/edit?usp=sharing doc on troubleshooting indexing problems Trevor will go through the spreadsheet and add stubs as needed
10 mins	reviewing issues from Github	Font-weight on focus causes bounce on mouseover, accessibility issue · Issue #99 · archivesspace/tech-docs This one is related to the static site generator project Additional documentation needed on subrecords · Issue #71 · archivesspace/tech-docs Document plugin structure for public models · Issue #70 · archivesspace/tech-docs These are suggestions for new documentation from Alicia. We should consider adding stub pages for these. Unclear documentation on REST API · Issue #66 · archivesspace/tech-docs Documenting API endpoints that don’t require authentication. Might be an issue for API docs working group. Trevor will bring this up with API docs working group
20 mins	Tech Docs discussion at ArchivesSpace Online Forum, March 30, 2021 (12-4 pm ET)	Trevor will send a message to list asking for questions, etc. He will also make a list of documentation sources
10 mins	Any other business

Draft email to users lists to promote discussion session (so people will come with questions) (Trevor)

Add stub pages for topics in Github issues (@Alicia Detelich)

Begin (Trevor) and contribute to (all) a doc listing different indexing scenarios for a 'troubleshooting” page

List of documentation pages (repo, API docs, metadata mappings, etc.) to share at forum

Find existing stubs pages/sections in tech-docs repo

For API Working Group: add a note in documentation for endpoints that don’t require authentication