2024-11-18 Meeting Agenda

 Date

Nov 18, 2024

 Participants

  • @Rebecca Baugnon

  • @Jessica Crouch

  • @Elizabeth Delmage

  • @Kelly.Francis

  • @Matthew Gorham

  • @Amanda Greenwood

 Resources

User Documentation Review Process

User Documentation Style Guide

Future User Doc projects

https://docs.google.com/spreadsheets/d/1D6UvIp8iu4NSCcoaFxqRg9V0qluYj7yHfLs8daV8RJo/edit#gid=1782244462

Users Docs ArchivesSpace Instance

 

 Discussion topics

Agenda Item

Description

Notes

Agenda Item

Description

Notes

Documentation Progress

Bulk Update of Archival Objects

Importing Digital Objects within a Resource Record

Importing Location Records

Importing Subject Records

Importing Assessment Records

Importing Digital Object Data (under Importing and Exporting Data)

Importing Digital Object Data (under Managing Digital Objects)

Importing Accession Data (under Importing and Exporting Data)

Public Interface

Thanks for all the hard work and feedback!

Not sure how to add new pages/change order to list of section pages on Importing and Exporting Data.

Style Guide

Inconsistent style choices among documentation. Includes:

  • Image border choices (color, size)

  • Image caption and alt text choices (“Fig. 1” or more descriptive)

    • Style guide says to add alt text

  • Use of info panel notes (use per info panel; colors)

  • Use of bold vs. quotes to highlight/emphasize

    • Style guide says to use bold, but notes inconsistent use

  • Alignment of text on page (left vs. center)

    • (Style guide says to align left)

Re-review your assigned pages and make any adjustments based on what was determined today.

Kelly will update the Style Guide as necessary to reflect any decisions made.

User Doc Review Process

Added a sentence for primary watchers to also email secondary watchers when a page is ready for review.

 

Duplicate Documentation

Additional information can be found in the Future User Doc Projects page

 

UAC meeting - User Docs discussion

  • Topic

    • Overview of new/updated documentation related to the new release

    • Page consolidation project

User Docs will present at the November 19 meeting

 Action items

 

 Decisions