Zoom: https://us02web.zoom.us/j/87888134747
- Chair: Melissa
- Notes: Mirko
- Attending:
- Amy Blau
- Cary Gordon
- Danny Lamb
- Janice Banser
- Rosie LeFaive
- Yamil Suarez
- Islandora 8 Documentation
- Spreadsheet on Islandora 8 Documentaton
- Islandora 8 Documentation Issues
- Islandora 7 Documentation
- Updates on documentation changes since last meeting
- Workflow: Ensure users can provide feedback or suggest edits
- Updates on change to documentation footer (Cary)
- New how-to video(s) (Melissa): https://islandora.github.io/documentation/user-documentation/video-docs/
- Suggestions for new documentation themes
- Check documentation spreadsheet
- Adding page placeholders as suggested by Rosie (https://docs.google.com/document/d/1m3aySaqy3UVNLf4o1ZcLakUbPWoQi5nX1bgERRtMSU0/edit)
- ISLE docs
- CLA for documentation contributors
- Open pull requests: https://github.com/Islandora/documentation/pulls
- Accessibility
- Cooperation with Lyrasis around IMLS grant for Fedora migration
- Guidelines on the relationship between Readme files and documentation
- Best practices for creating documentation about new features (cf. notes from 18 November 2020)
- New committers added to documentation, new videos added, added information why we make Media in I8, Islandora/documentation#1708
- How-to video on how to create an issue: online
- New documentation themes:
- Material theme seems significantly more popular than others, highly complete feature-wise
- Cinder theme looks pretty, but is based on Bootstrap 3 (current is Bootstrap 4)
- Bootstrap.386 is an option for special occasions like April 1st (https://gitlab.com/lramage/mkdocs-bootstrap386)
- Integrate Rosie's suggested pages into documentation spreadsheet
- Documenting "the Islandora way" at higher conceptual level? Possibly too early, users need to start understanding how I8 does things compared to I7
- Reference documentation: useful, what would be relationship between Readme files and documentation? Cf. https://islandora.github.io/documentation/technical-documentation/diagram/ - possible starting point list of features provided by Islandora default
- Align Islandora defaults features with Functional requirements? ICG currently working on this list, Amy can find out more
- How to break down documentation of Islandora defaults? https://github.com/Islandora/islandora_defaults - first pass with comprehensive list of what Islandora Defaults does/provides
- Danny working on ISLE readme/technical documentation (Islandora/documentation#1712), welcomes comments on issue
- Melissa suggests creating documentation team on GitHub to ping possible reviewers
- CLA for documentation contributions: clarification that documentation contributors need to sign CLA (https://github.com/Islandora/islandora/wiki/Contributor-License-Agreements)
- Documentation link leads to page which is sub-entry in documentation menu structure, navigating to full menu tree confusing in some views. Consider creating top-level menu entry for "about" landing page. It might be the case that MkDocs doesn't allow a top-level menu entry to be a page at the same time, so menu entries with children might need a landing page for the respective category.
- [] Update footer to include information about making changes to documentation (Cary)
- [] Delve into Material theme documentation to check for features that are possibly useful: https://squidfunk.github.io/mkdocs-material/
- [] Rosie will compile a list of features of what Islandora Defaults provides
- [] Melissa will create a new group of Documentation reviewers on GitHub to tag them on
- [] Test behavior of menu items which have children, possibly create landing pages