2020-04-06 Documentation meeting agenda/notes

Note taker: Krista Oldham (Unlicensed)

(Next note taker: )

Jessica at impromptu online Intro to ArchivesSpace training we’re holding on Monday and Tuesday during the time of the UAC meeting. Her update:

We’ve had a surge in users accessing the user manual in the past weeks as people move to a WFH environment and prioritize working in ArchivesSpace since it is one of the few archival tasks you can do from home.  We’ve received a few comments directly on the manual recently as more people are reading the pages but these comments have been catching typos and small fixes primarily (which is great).  I’ve been fixing those as they come in.  I’ve also edited content on the Creating Accessions page to reflect ArchivesSpace only requires an identifier to save an accession record, not identifier and date.  I also updated the page related to Creating Subjects records to include a key to the icons that correspond to different types of subjects.

• Update on action item from last meeting – will make revisions to outline and share with the group for another round of review 14 Feb 2020 

Revisions: UAC Documentation - Review Process (changes tracked in document)

 Everyone review the UAC Documentation Process by 17 Apr 2020 

Use inline comments for any corrections. Also add an inline comment at the top to indicate that you have reviewed the document.  

• Update on style guide User Documentation Style Guide (team planning notes)
• Do we want to utilize the versioning features?
• Should we utilize templates to help streamline the creation of pages?

Tried to outline a style guide and established steps to complete and build on as we go along.

• Step 1. Layout and format - create a template addresses font, paragraphing format, formatting headings and screen shots. 
• Step 2. Content structure addresses layout, linking to glossary, and abbreviations.
• Step 3. Format the style guide to mirror the style guide.
• Step 4. Use cases
• Step 5. Global application

Style Guide will be cleaned up as they go along. First steps are to address basic formatting, followed by more detailed formatting guidelines. 

Note: The style guide was built for Confluence, but with an awareness that the manual may move out of the system in the future.

For the time being we will focus just on on the skeleton buildout and then circle back to discuss and work through some of the questions related to versioning, page watching, and level's of detail on pages that need more discussion.  

Still be looking for someone to eventually take lead of the team. Jasmine wants to be working with this person starting in the spring to ensure smooth transition.