2015-09-24 Meeting notes

2015-09-24 Meeting notes

Date

Sep 24, 2015

Attendees

  • @Ann Cooper (Unlicensed)

  • @Rachel Maderik (Unlicensed)

  • @Scott Hanrath (Unlicensed)

  • @BradleyW (Unlicensed)

  • @Sally Vermaaten (Unlicensed)

Goals

  • Review existing documentation.

  • Determine goals and workplan for the upcoming year.

Discussion items

Time

Item

Who

Notes

 

Review existing documentation

All

  • The group’s immediate task is to review all current documentation, which exists in multiple locations (on GitHub, Confluence, and the ArchivesSpace website). We need to identify how they are connected, where they are being linked from, and whether any content is inaccurate, out of date, or redundant. It may be helpful to create an inventory spreadsheet of where each existing piece of documentation is linked from.

  • Identify project documentation versus technical documentation, and determine what the relationships between them are (as well as what they should be). E.g., the Confluence wiki should be primarily project documentation, but it currently contains technical documentation as well (such as how to commit code).

 

Knowledgebase

Brad

  •  Future goal to create a queryable knowledgebase of technical questions, primarily populated by content discussed on the listservs. Recommended the MySQL Forum Knowledgebase as a model.

 

Status of last year's projects

Scott

  • Reviewed list of tasks identified by last year’s group (“Suggested documentation team tasks”). Most have not been completed. They did perform an inventory of gaps in the documentation as identified by questions on the listserv, which has been posted on Confluence (“Listserve issues to add to documentation”). Recommended completing our review of the current documentation before addressing the task list, as we will have a better idea of our workplan and goals for the year at that point.

 

Video tutorials

Brad

  • There is an opportunity to provide short video tutorials/screencasts (3-8 minutes long) on technical topics (e.g., how to migrate an Archon database, how to install ArchivesSpace, how to customize an importer). There is a small amount of funding available for each video. Recommended inviting Christine to a meeting to talk about this project.

 

Subteam wiki page

Sally

  • It would be good to see subteams create a page in the wiki, with a section outlining our workplans and identifying deadlines.

 

Future meetings

All

  • Brad recommended scheduling a monthly standing meeting. Ann will send out a poll to decide on next month's meeting.

Action items

@Rachel Maderik (Unlicensed) will review documentation on GitHub.
@Scott Hanrath (Unlicensed) will review documentation on the ArchivesSpace website.
@Ann Cooper (Unlicensed) will review documentation on the Confluence wiki.
@Ann Cooper (Unlicensed) will begin a workplan on the TAC wiki page.