Collections

docs/concepts/collection.md

@@ -0,0 +1,29 @@
+# Collections
+
+Collections are groups of related content that can be viewed or managed as a unit.  Islandora-specific use cases include:
+
+- an archival fonds that needs to be grouped together, with internal hierarchy
+- various collections of artifacts, grouped for display
+- theses and dissertations, which are organized and managed separately from other objects.
+
+Islandora can:
+
+- declare items as members of other objects
+- after declaring an item "a collection", display a view of its members
+
+Management of the objects of a collection is not yet readily built in, but such actions as deleting, changing visibility or permissioning on a collection should be possible through Views Bulk Edit and other contrib modules, such as Permissions By Term.
+
+## Configuration provided by Islandora Defaults
+Islandora (Defaults) provides:
+
+- A membership relationship for members (“children”) to point to their parent collection
+- A View (template) to display the members of a collection on the collection’s page
+- Batch-editing tools that can be used on collections
+
+Islandora uses a generic "member of" relationship field to group objects under a "parent" object. This mechanism is shared by Paged Content and by Compound Objects.
+
+In Islandora Defaults, when content is given the Model of “Collection”, then a Context kicks in (the context is called “Collection”) that causes a view block (the View’s name is Members) to appear on the page. 
+
+## Tutorials
+
+- [How to create and add to a collection](../tutorials/how-to-create-collection.md)

docs/user-documentation/collections.md → docs/tutorials/how-to-create-collection.md

@@ -1,12 +1,15 @@
-Collections are groups of repository content that can be described themselves. Repository content is aggregated in a collection by setting the `field_member_of`
-entity reference field to point to a collection. Generally speaking, anything can behave as a collection, and anything with `field_member_of` can be a member of a collection.
-However, Islandora provides a "Collection" taxonomy term in the Islandora Models vocabulary that can be used to trigger collection-specific behavior.
-For example, a context provided by Islandora Defaults will display a list of child resource node teasers on the resources' display page when this term is applied to the `field_model` field.
-
-!!! Tip "Collections and Deleting"
-    Collections and their members are
-    independent of each other, and removing something from a collection does not delete it.  **Similarly, deleting a
-    collection does not delete its members.**
+# How to create and add to a Collection
+
+This how-to demonstrates creating a collection and adding items to it in Islandora Defaults. For more about collections, see [Concept: Collection](../concepts/collection.md).
+
+## Introduction
+
+In Islandora Defaults, Collections that are tagged as "Collection" under System > Model will show a view of their member objects. A member is any object that is "member_of" that object, and can be added via the "Members" tab. This is the mechanism in Islandora Defaults; individual instances may vary.
+
+!!! Warning "Collections and Deleting"
+    Collections and their members are independent of each other, 
+    and removing something from a collection does not delete it. 
+    **Similarly, deleting a collection does not delete its members.**
 
 ## Creating a Collection
 

mkdocs.yml

@@ -48,6 +48,7 @@ nav:
   # what everybody needs to know to understand Islandora and interact with it
   # Possibly add page/section: How to use this documentation (containing user role definitions)
   - Concepts:
+      - 'Collections': 'concepts/collection.md'
       - 'Component Overview': 'installation/component_overview.md'
           # moved from "Installation" section; alternatively duplicate a simplified version in the overview section
           # also see Architecture Diagram in Developer documentation
@@ -88,7 +89,9 @@ nav:
       # explaining why, and let the user decide if they want to look deeper at 
       # what these concepts are. 
       - 'Create a Resource Node': 'tutorials/create-a-resource-node.md'
-            # procedural, for people learning what islandora is. 
+          # procedural, for people learning what islandora is. 
+      - 'Create a Collection': 'tutorials/how-to-create-collection.md'
+          # procedural, repository managers/ curators
       - 'Video Documentation': 'user-documentation/video-docs.md'
           # mostly procedural, repository managers
 
@@ -112,9 +115,6 @@ nav:
         - 'Media': 'user-documentation/media.md'
               # conceptual and procedural, repository managers
               # move out procedural description for deleting Media
-        - 'Collections': 'user-documentation/collections.md'
-              # conceptual and procedural, repository managers/ curators
-              # move out procedural description for creating and populating collections
         - 'Paged Content': 'user-documentation/paged-content.md'
               # conceptual and procedural, repository managers/ curators
               # move out procedural description for ordering pages