From df5d105eabbd8febcdcce35123af762a814a2d86 Mon Sep 17 00:00:00 2001
From: mariagrimaldi <maria.grimaldi@edunext.co>
Date: Wed, 21 Jul 2021 18:28:47 -0400
Subject: [PATCH] docs: add inline code-annotations following Feature Toggle
 style docs

---
 openedx_events/learning/signals.py | 72 +++++++++++++++++++++++++++++-
 1 file changed, 71 insertions(+), 1 deletion(-)

diff --git a/openedx_events/learning/signals.py b/openedx_events/learning/signals.py
index 5aa5f1c4..df4f76cf 100644
--- a/openedx_events/learning/signals.py
+++ b/openedx_events/learning/signals.py
@@ -16,6 +16,14 @@
 )
 from openedx_events.tooling import OpenEdxPublicSignal
 
+# ..event_type: org.openedx.learning.student.registration.completed.v1
+# ..event_name: STUDENT_REGISTRATION_COMPLETED
+# ..event_version: V1
+# ..event_implementation: OpenEdxPublicSignal(DjangoSignal)
+# ..event_description: emitted when the user registration process in the LMS
+# is completed.
+# ..event_data: UserData
+# ..event_creation_date: 2020-22-07
 STUDENT_REGISTRATION_COMPLETED = OpenEdxPublicSignal(
     event_type="org.openedx.learning.student.registration.completed.v1",
     data={
@@ -24,6 +32,14 @@
 )
 
 
+# ..event_type: org.openedx.learning.auth.session.login.completed.v1
+# ..event_name: SESSION_LOGIN_COMPLETED
+# ..event_version: V1
+# ..event_implementation: OpenEdxPublicSignal(DjangoSignal)
+# ..event_description: emitted when the user's login process in the LMS is
+# completed.
+# ..event_data: UserData
+# ..event_creation_date: 2020-22-07
 SESSION_LOGIN_COMPLETED = OpenEdxPublicSignal(
     event_type="org.openedx.learning.auth.session.login.completed.v1",
     data={
@@ -32,6 +48,13 @@
 )
 
 
+# ..event_type: org.openedx.learning.course.enrollment.created.v1
+# ..event_name: COURSE_ENROLLMENT_CREATED
+# ..event_version: V1
+# ..event_implementation: OpenEdxPublicSignal(DjangoSignal)
+# ..event_description: emitted when the user's enrollment process is completed.
+# ..event_data: CourseEnrollmentData
+# ..event_creation_date: 2020-22-07
 COURSE_ENROLLMENT_CREATED = OpenEdxPublicSignal(
     event_type="org.openedx.learning.course.enrollment.created.v1",
     data={
@@ -40,6 +63,14 @@
 )
 
 
+# ..event_type: org.openedx.learning.course.enrollment.changed.v1
+# ..event_name: COURSE_ENROLLMENT_CHANGED
+# ..event_version: V1
+# ..event_implementation: OpenEdxPublicSignal(DjangoSignal)
+# ..event_description: emitted when the user's enrollment update process is
+# completed.
+# ..event_data: CourseEnrollmentData
+# ..event_creation_date: 2020-22-07
 COURSE_ENROLLMENT_CHANGED = OpenEdxPublicSignal(
     event_type="org.openedx.learning.course.enrollment.changed.v1",
     data={
@@ -48,14 +79,30 @@
 )
 
 
+# ..event_type: org.openedx.learning.course.unenrollment.completed.v1
+# ..event_name: COURSE_ENROLLMENT_CHANGED
+# ..event_version: V1
+# ..event_implementation: OpenEdxPublicSignal(DjangoSignal)
+# ..event_description: emitted when the user's unenrollment process is
+# completed.
+# ..event_data: CourseEnrollmentData
+# ..event_creation_date: 2020-22-07
 COURSE_UNENROLLMENT_COMPLETED = OpenEdxPublicSignal(
-    event_type="org.openedx.learning.course.enrollment.deactivated.v1",
+    event_type="org.openedx.learning.course.unenrollment.completed.v1",
     data={
         "enrollment": CourseEnrollmentData,
     }
 )
 
 
+# ..event_type: org.openedx.learning.certificate.created.v1
+# ..event_name: CERTIFICATE_CREATED
+# ..event_version: V1
+# ..event_implementation: OpenEdxPublicSignal(DjangoSignal)
+# ..event_description: emitted when the user's certificate creation process is
+# completed.
+# ..event_data: CertificateData
+# ..event_creation_date: 2020-22-07
 CERTIFICATE_CREATED = OpenEdxPublicSignal(
     event_type="org.openedx.learning.certificate.created.v1",
     data={
@@ -64,6 +111,14 @@
 )
 
 
+# ..event_type: org.openedx.learning.certificate.created.v1
+# ..event_name: CERTIFICATE_CREATED
+# ..event_version: V1
+# ..event_implementation: OpenEdxPublicSignal(DjangoSignal)
+# ..event_description: emitted when the user's certificate creation process is
+# completed.
+# ..event_data: CertificateData
+# ..event_creation_date: 2020-22-07
 CERTIFICATE_CHANGED = OpenEdxPublicSignal(
     event_type="org.openedx.learning.certificate.changed.v1",
     data={
@@ -72,6 +127,14 @@
 )
 
 
+# ..event_type: org.openedx.learning.certificate.revoked.v1
+# ..event_name: CERTIFICATE_REVOKED
+# ..event_version: V1
+# ..event_implementation: OpenEdxPublicSignal(DjangoSignal)
+# ..event_description: emitted when the user's certificate annulation process is
+# completed.
+# ..event_data: CertificateData
+# ..event_creation_date: 2020-22-07
 CERTIFICATE_REVOKED = OpenEdxPublicSignal(
     event_type="org.openedx.learning.certificate.revoked.v1",
     data={
@@ -80,6 +143,13 @@
 )
 
 
+# ..event_type: org.openedx.learning.cohort_membership.changed.v1
+# ..event_name: COHORT_MEMBERSHIP_CHANGED
+# ..event_version: V1
+# ..event_implementation: OpenEdxPublicSignal(DjangoSignal)
+# ..event_description: emitted when the user's cohort update is completed.
+# ..event_data: CohortData
+# ..event_creation_date: 2020-22-07
 COHORT_MEMBERSHIP_CHANGED = OpenEdxPublicSignal(
     event_type="org.openedx.learning.cohort_membership.changed.v1",
     data={