Date

2018 December 3

Attendees

Kevin Clair
Jasmine Jones
Ashley Knox
Susan Luftschein
Brittany Newberry
Jamie Weeks
John Zarrillo

Goals

Review survey results and prioritize tasks
Documentation ideas referred from TAC
Other items of business

Conference call info

Join from PC, Mac, Linux, iOS or Android: https://udenver.zoom.us/j/241222401

Or iPhone one-tap :
US: +16699006833,,241222401# or +16465588656,,241222401#

Or Telephone:
Dial(for higher quality, dial a number based on your current location):
US: +1 669 900 6833 or +1 646 558 8656
Meeting ID: 241 222 401
International numbers available: https://zoom.us/u/addg6J02MY

Discussion items

Time	Item	Who	Notes
	Roll call
	Review survey results and prioritize tasks		Link to survey results Link to key takeaways from survey results Review: The committee surveyed the community last summer regarding their use of the existing documentation, as well as suggestions for how to improve it. Broadly, we found the following: it's written at a very high level, and doesn't provide extensive technical detail for those who desire it its structure for access and discoverability could be improved it could benefit from a serious re-working (though unsure what that would look like...) suggestions for alternatives to the current application on which the docs are built? John Z. asked if there was anyone (either on the call or in the community) who had screenshots or examples of how to accomplish certain tasks in ArchivesSpace that they would be willing to share for the official documentation. This is a call we could put out to the users' group
	Documentation ideas referred from TAC		Embedding images into Digital Objects in the PUI (link) Adding staff interface hot-key shortcuts to the docs (link) Trainer's team booklet -- could it be incorporated into the core docs? Does it need to be updated? Check in with Christine Kim about it before she leaves? Other questions for LYRASIS that came up as part of this discussion: Is it feasible to make the app documentation open-access? What application runs the documentation? Who is responsible for creating screencasts about ArchivesSpace, in terms of the UAC? Is it this group, or the UAC as a whole? If us, how would we go about creating and posting those? Is there anything in LYRASIS' training manual that could be incorporated into the core documentation?
	Other items of business		Survey of documentation writers: What have you written? What might you contribute to the core docs? Examples: E-mail to the list from Miloche Kottman on Nov. 27 about batch re-ordering; our (DU) own stuff online at https://duspeccoll.github.io Discussion among the group re: documentation writer survey: who's writing? why are they writing? would they contribute to the core docs? Susan L.: Collection Management Tools Section SAA -- lots of docs available on their microsite Jasmine: linking to github repos as well as traditional text documentation (something the CMT section looked into but didn't pursue in depth) Jamie: They created their own user manual with screenshots (!) John: They have their own manual at NYU (the "local manual") -- it's mostly for their local practices but it also functions as de facto ArchivesSpace documentation. NYU doesn't really use the docs at all Possible questions to ask in a documentation writer survey: Why are they writing it on their own? Are they willing to share that documentation? Did they consult the official manual when putting together documentation? Were they aware of the official manual when putting together documentation? Make it easier to integrate the official manual with local documentation (making the official docs public could help with that...) Who is responsible for documentation? How much of a commitment of time is it to build and maintain documentation?

Action items

Volunteers to focus on improving different sections of the documentation (either through feedback or revisions)
Call for screenshots or examples to include in the official documentation
Investigate usability studies on the documentation itself
Jasmine Jones (Unlicensed) write up how to embed digital object images in the PUI
Kevin Clair write up a list of available hotkeys in the staff interface

Browser not supported