docs: more source info

Author: saraburns1

models/_docs/docs.md

@@ -106,3 +106,10 @@ The username of the learner
 {% docs verb_id %}
 The xAPI verb identifier
 {% enddocs %}
+
+
+{% docs object_tag_source %}
+Course objects and their associated tags from CMS events:  
+`COURSE_CREATED, XBLOCK_CREATED, LIBRARY_BLOCK_CREATED, CONTENT_OBJECT_ASSOCIATIONS_CHANGED`  
+and `post_save` Django signal on the Object Tag model
+{% enddocs %}

models/courses/sources.yml

@@ -7,7 +7,7 @@ sources:
     tables:
 
       - name: course_blocks
-        description: "XBlock data from CMS COURSE_PUBLISHED events"
+        description: XBlock data from CMS `COURSE_PUBLISHED` events
         columns:
           - name: org
             description: '{{ doc("org")}}'
@@ -38,7 +38,7 @@ sources:
             type: String
 
       - name: course_overviews
-        description: "Course metadata from CMS COURSE_PUBLISHED events"
+        description: Course metadata from CMS `COURSE_PUBLISHED` events
         columns:
           - name: org
             description: '{{ doc("org")}}' 

models/tags/sources.yml

@@ -6,9 +6,7 @@ sources:
     tables:
 
       - name: object_tag
-        description: >
-          Course objects and their associated tags from events:
-          CMS - COURSE_CREATED, XBLOCK_CREATED, LIBRARY_BLOCK_CREATED, CONTENT_OBJECT_ASSOCIATIONS_CHANGED
+        description: '{{ doc("object_tag_source") }}'
         columns:
           - name: id
             description: '{{ doc("id") }}'
@@ -39,7 +37,7 @@ sources:
             type: String
 
       - name: taxonomy
-        description: Taxonomy data table
+        description: Taxonomy data from `post_save` Django signal on the Taxonomy model
         columns:
           - name: id
             description: '{{ doc("id") }}'
@@ -55,7 +53,7 @@ sources:
             type: String
 
       - name: tag
-        description: All tags for all taxonomies. Includes parent tag and lineage string for heirarchal relationships
+        description: Tag data from `post_save` Django signal on the Tag model. Includes parent tag and lineage string for heirarchal relationships.
         columns:
           - name: id
             description: '{{ doc("id") }}'

models/users/sources.yml

@@ -6,7 +6,7 @@ sources:
     tables:
 
       - name: user_profile
-        description: All users and associated data
+        description: Users and associated data from `post_save` Django signal on the UserProfile model
         columns:
           - name: id
             description: '{{ doc("id") }}'
@@ -72,7 +72,7 @@ sources:
             type: String
 
       - name: external_id
-        description: User ID with external id
+        description: User ID with external id from `post_save` Django signal on the ExternalId model
         columns:
           - name: external_user_id
             description: "The external user id"