Merge pull request #1626 from ualbertalib/add-description-to-status-enum

#1615: Document Status enum on DraftItem/DraftThesis models in detail

app/models/concerns/draft_properties.rb

@@ -4,6 +4,11 @@ module DraftProperties
   UNIVERSITY_INCEPTION_YEAR = 1908
 
   included do
+    # "status" enum is for keeping track of where a draft object is within the deposit wizard workflow
+    # Possible status values are as follows:
+    # inactive: Draft objects where the user never passed first step of deposit wizard.
+    # active: Draft objects where the user made it passed first step, but hasn't finished completing the deposit wizard.
+    # archived: Draft objects that have been "published" where a user has successfully deposited and completed the deposit wizard.
     enum status: { inactive: 0, active: 1, archived: 2 }
 
     # Note that dependent: false is necessary here as Items and DraftItems can both have ActiveStorage::Attachment records