Documenting what you need to know about Drupal in order to set up your Islandora

[ysuarez]

As we transition on using Drupal itself to do work, instead of custom Islandora modules, we want to make sure we document/explain common Drupal concepts.

List of potential Drupal topics:

• What are Drupal entities: https://www.youtube.com/watch?v=coephBu07Ks (Drupalize.me, ca. 15 min)
• Content types and Fields: https://www.youtube.com/watch?v=tj5E-jdQehw (ca. 9 min)
• Views (already documented):
  • Basic views https://www.youtube.com/watch?v=Ge14g8nBUBQ (Melissa, 4:40 min)
  • Advanced views https://www.youtube.com/watch?v=inPRZeQGnKI (Melissa 6:47 min)
• Taxonomies
  • Introduction to Taxonomy https://www.youtube.com/watch?v=upFz4WrJ1-Q (ca. 2 min)
  • Adding a Taxonomy https://www.youtube.com/watch?v=6x0HXEv2lcA (4:36 min)
  • already documented: Add a new taxonomy term https://www.youtube.com/watch?v=FEb2yOWg140 (Melissa, 2:10 min)

@Islandora/documentation

[amyrb]

• It probably makes sense to link to the Drupal 8 User Guide This doesn't have super-detailed explanations for everything, but you can get an idea of what Drupal functions are being used in Islandora from it.
• Drupal configuration in Islandora defaults -- we have some documentation, but it would be helpful to update (comments within the documentation indicate some functionality is unknown) and perhaps to produce a more beginner-friendly walkthrough of how all of this works -- how resource types and display contexts intersect, for example, and how those interact with a given theme.
• Search and faceting. We have some documentation on setting up facets as part of the Configure Advanced Search section, but this might be helpful as a video, especially since the required Drupal facets module doesn't currently seem to be part of Islandora defaults. Drupal videos on Search API and facets for 8 seem to be on the long side.
• Entity references -- we don't have a lot of information on Linked Agents and Entity References in the Islandora documentation right now. There is a short Drupal video on Connecting content types with entity references that is relevant, but it would probably be more helpful to have an Islandora video that uses the Repository Item Linked Agent field to explain. It's also probably important to include some written documentation that goes through what it looks like to use Linked Agent fields in metadata and in facets.

[ysuarez]

I would like to suggest that we add to our list the recent Drupal Views presentation by @rosiel:

Drupal Views for Islandora Users
https://www.youtube.com/watch?v=sJfojxRRsgQ

I was also tempted to add a link t this video on this page...

Create or Update a View
https://islandora.github.io/documentation/tutorials/create_update_views/