Skip to content

Latest commit

 

History

History
62 lines (50 loc) · 3.34 KB

08-11-21.md

File metadata and controls

62 lines (50 loc) · 3.34 KB

Documentation Interest Group — August 11, 2021 — 2:00 PM Eastern

Zoom: https://us02web.zoom.us/j/87888134747

Attendance

  • Mirko Hanke
  • Amy Blau
  • Melissa Anez
  • Rosie Le Faive
  • Yamil Suarez

Resources

Agenda

  • Open pull requests: https://github.com/Islandora/documentation/pulls
  • Discuss: Feature parity document, who should maintain it? Conversation with Tech Call, ICC, Leadership?
  • Discuss: Role for DIG to curate/manage issues labeled 'documentation'?
  • Documentating what you need to know about Drupal in ordert to set up your Islandora
  • MIG working on glossary, integration with documentation?
  • (Time permitting:) Discuss: Pain points raised by ICG report?
  • Revisit: Action items

Notes

Changes to template to facilitate documentation issues

  • Proposal to add a reminder to the pull request template to prompt documentation
  • Change approved

Open pull requests

  • Yamil reached out to outside committer re CLA, no response. Yamil will recreate the commit to capture the information, then we will close the PR with a note that we tried to contact re. CLA.
  • Release notes PR -- Melissa will reach out to Tech Call to see what needs to be done before it can be merged.
  • How to release -- waiting on more information from Danny.
  • Manual install PR -- waiting on someone to test the new documentation before it's merged.

Feature parity document discussion

  • DIG not the owner of this document, will not maintain it, but will help contribute and distribute
  • We will revisit the document regularly, can check whether individual features are already in documentation.
  • Some discussion of how the feature parity document relates to the IF Executive Director position role.

Managing issues labeled documentation

  • Currently there are 43 open issues
  • We will make a standing agenda item to look at 2-3 old issues per DIG meeting plus new ones, to clean up gradually.

Drupal prerequisites to set up Islandora

  • Ongoing open issue. Need to decide whether this is one page or can be incorporated into existing documentation.
  • Some discussion of using open meeting demos etc. in documentation.

Revisit remaining agenda items at next meeting, start thinking about a sprint in the fall.

Action items

  • Melissa creates issue for moving cookbook into documentation: Islandora/documentation#1873
  • Yamil creates meta-issue for Drupal prerequisites/concepts: Islandora/documentation#1874
  • (long term) Removing "8" from docs, as we switch to numberless branding.
  • Co-conveners will come up with text for I8 welcome page based on example Islandora/documentation#1787
  • Yamil to make PR for Issue templates
  • Draft email message for contacting possible contributors to Manual Install documentation
  • Try different approaches for asking contributors to initiate/provide material for documentation
  • Make standing agenda item to review documentation issues