2017-11-17 Meeting notes
Date
Attendees
- Christine Di Bella
- Laney McGlohon
- Peter Carini
- Megan Blair (regrets)
- Ed Busch
- Terry Catapano (regrets)
- Mark Cooper
- Patrick Galligan
- Scott Hanrath
- Maggie Hughes
- Jason Loeffler
- Rachel Maderik
- Julia McGinnis (regrets)
- Cory Nimer
- Dallas Pillen
- Terry Reese (regrets)
- Kari Smith
- Dustin Stokes
- Trevor Thornton
Goals
- Review sub-team work plans, introduce ad hoc working groups and discuss outreach idea.
Discussion items
Time | Item | Who | Notes |
---|---|---|---|
5min | Roll call and note taker | Bobbi, notetaker | |
5min | Recent contributions | Listserv:
Code:
Bug reporting:
| |
5min | Program update | Christine Di Bella or Laney McGlohon | Christine: put out today: release 2.2.1, mostly bug fixes and community pull requests. Working on documents relating to making it clearer and more transparent on how contributions are evaluated; different kinds of development one can do and ways that plugins can be converted into the main code body. Engagement things going to be happening, including the webinar on testing next month. Laney: migration tools: co-op student, Sarah, from Georgia Tech working on upgrading migration tools; have a test version of the migration tool, getting good feedback from some users. Hoping to get release out early December, first AT, then Archon. Would like more Archon databases to test. Promise to destroy it! after testing. co-op student also working on documenting datamaps, plus some pointers to make migration go faster (like turning off PUI indexing |
5min | "Reporting line" for cross council sub-teams | Two groups: this one, and User Advisory Council. Two sub-teams are cross-council: Development prioritization sub-team and Testing sub-team. | |
10min | Sub-team (other other) updates | Laney McGlohon, Jason Loeffler, Patrick Galligan, Dustin Stokes, Scott Hanrath | Core committers group (Laney reports:) working on making test less brittle; in December will make a plan for how to approach the testing work for January. Development prioritization sub-team (cross council with UAC) (Jason:) continuing to work through already-developed process in grading, ranking bugs and feature requests. Getting a decent number of issues being realized in releases. Participating in the document circulating concerning the process of evaluation. Would like to make the team's work more easily revealed to the AS member cohort. Surveys and revising sub-team mission statement will be discussed in the next couple of meetings. Integrations sub-team (Patrick:) Coming out of first meeting, going to try to come up with a mission statement that would let them get more involved with the larger community on an on-going basis, whether it's being more active on listserv, or letting community know who in the community is doing interesting things. Thinking about possibly creating/contributing to an AS blog, as well as possibly having regular open calls with the community. Possibly building out more information on integrations on the AS GitHub pages. Tracking ongoing integrations and maintaining the wiki. Migration sub-team
(Dustin:) had undergone a lot of turnover; still working on workplan; expect business as usual in terms of working with the community. Technical documentation sub-team (Scott:) had a couple of calls; workplan focuses on 3 areas: 1. moving main tech. documentation into a separate github repository to make it cleaner and easier for maintenance and contributions from community, allowing pull-requests more easily, etc. 2. enhancing provisioning documentation (setting up solr server, doing https, etc.) 3. plugin documentation, what can you do with them, best practices, etc. Patrick: would the integrations sub-team documentation be welcome? Scott: would like people to be in touch to work this out. Testing sub-team (cross council with UAC) (Ed:) were involved with 2.2 testing; there's another release coming in December with an expected full-test suite on. |
5min | Ad hoc working groups | Dallas Pillen and Maggie Hughes | API Documentation Working Group Purpose: Create documentation and/or screencasts for using the ArchivesSpace API, including JSON examples for post bodies/responses. The need for this kind of information came up on the listserv as recently as (11/13). This working group would be responsible for determining the scope and timeline of this work (because it could be a huge amount of work!), its relationship to the existing API autodocs, its format, where it would live, etc., as well as how it it would be promoted and maintained going forward. (Dallas:) People have talked about improving the API documentation. Very open to ideas about direction of this group. Try to write documentation for the endpoints that people generally would want to use – identifying subset, with realistic examples. Sometime soon there will a be call for participants, and then will try to nail down directions for moving forward. Some of the work of this group might intersect with the Tech. Documentation group, so will need to work that out. Q: is there a timeline? A: not yet. Next week, will send a call for interested people, then call a kick-off meeting. Unlikely to begin before end of the year. Awesome ArchivesSpace Working Group Create an Awesome List repository (or similar), to live in the ArchivesSpace or ArchivesSpace-Labs GitHub organization. The list would start with two categories (which could be expanded later) based on the interests of the current cohort of TAC members: migrations and plug-ins. It would point to items that are and aren't maintained by the ArchivesSpace program team, and that are inside and outside of the existing ArchivesSpace repos. Inclusion on the list wouldn't represent an endorsement of any kind. The working group would be responsible for the initial population of the list and provide a plan for promoting and adding to and maintaining it going forward. For an example of what this might look like, see the IIIF Awesome List. (Maggie:) Would be looking to include technical documentation from the other working groups, soliciting from community, making sure there's ongoing maintenance. Plan to start working on the workplan more substantially after the new year. |
10min | Discussion: ArchivesSpace process for evaluating potential feature contributions to the core code | ArchivesSpace Process for Evaluating Potential Feature Contributions to the Core Code Comments? Pointed out that there are substantive comments in the document. Q: is commenting restricted to this group? A: TAC and UAC so far; the link can be sent to anyone. Looking to finalize by end of the year, so looking for feedback by end of this month (November). Of course will be open to anyone once finalized. "If we feel it's pretty thorough, maybe we can finalize it without distributing to the entire community" – Christine Christine invites more comments on the document. | |
5min | Discussion: Blog posts for TAC and sub-teams | Max: discussion about contributing to blog, but not sure how it gets advertised. Kari: tweeting out links to the wikis? Would reach a different audience than posting to listserv Laney: (Max has to-do to reach out to Christine Kim, who has ideas about outreach) Max asks if other sub-teams want to participate. Jason: want to make sure that whole life cycle of issue or bug is available. Putting that in capsule format would do a lot to encourage engagement, and dispel myth of "black hole" | |
5min | Discussion: "Best practices" for descriptive metadata in Archival Objects and Digital Objects | Couple of discussions on the list on the relationship between the descriptive metadata of Dig. objects vs. arch. objects. Kari: thought there was some issue for copying title over from archival object to digital object if digital objects were spawned from the archival object. Jason: that got tabled because got folded into the question of the inheritance model. Needs to be taken up. He'll take an action item to raise with Christine. There's an opportunity to refactor digital object model, considering inheritance, sketching out possible use cases. | |
5min | Open Mic |
Action items
- Max Eckard will clean up TAC space.
- Max will reach out to Christine Kim about outreach ideas.
- Jason will reach out to Christine about digital object models, etc.