Documentation Interest Group — July 14, 2021 — 2:00 PM Eastern

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

Attendance

Danny (chair)
Amy
Melissa
Mirko (notes)
Rosie
Yamil

Resources

Agenda

Open pull requests: https://github.com/Islandora/documentation/pulls
Where should the Islandora Cookbook live?
Documentating what you need to know about Drupal in ordert to set up your Islandora
Other topics?

Notes

Open pull request
- PR1860: typo fix? merged
- PR1816: ping PR committer again about CLA
- PR1797: Danny will respond to Mark
- PR1789: Danny to follow up
- PR1872: new PR about how to release, plausibility check
Where should the cookbook live?
- official documentation vs. Github repo, 'use as your own risk'
- current official documentation already contains recipe-style content
- Islandora is generally considered 'use at own risk'
- Managing expectations?
- Tagging documentation pages as recipes, extension?
- Suggestion to add "cookbook" section to documentation
- Easiest way to integrate: add separate section/folder
- Melissa will create issue for moving cookbook into main documentation
Documenting Drupal prerequisites
- A lot necessary, but would be nice to have
- Conceptual knowledge, practical knowledge
- Comparing Islandora 7 and Islandora 8
- official Drupal documentation is a mess
- Video tutorials: short and targeted
- Hackdoc-style workshop for documentation
- Existing Drupal tutorials, sustainability of Youtube videos?
- Solicit feedback from others about Drupal concept/practice knowledge that's missing from documentation
- Amy starts an issue with ideas about Drupal concepts we should cover
Other topics
- Summer of Islandora, videos possibly content for documentation?

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