docs: Update docstrings to valid rst syntax.

Author: feanil

backend/sample_plugin/apps.py

@@ -33,13 +33,12 @@ class SamplePluginConfig(AppConfig):
     - Add custom business logic
 
     Entry Point Configuration:
-    This plugin is registered in setup.py as:
-    ```python
-    entry_points={
-        "lms.djangoapp": ["sample_plugin = sample_plugin.apps:SamplePluginConfig"],
-        "cms.djangoapp": ["sample_plugin = sample_plugin.apps:SamplePluginConfig"],
-    }
-    ```
+    This plugin is registered in setup.py as::
+
+        entry_points={
+            "lms.djangoapp": ["sample_plugin = sample_plugin.apps:SamplePluginConfig"],
+            "cms.djangoapp": ["sample_plugin = sample_plugin.apps:SamplePluginConfig"],
+        }
 
     The platform automatically discovers and loads plugins registered in these entry points.
     """  # noqa:

backend/sample_plugin/pipeline.py

@@ -12,7 +12,7 @@
 
 Key Concepts:
 - Filters receive data and return modified data
-- They run at specific pipeline steps during platform operations  
+- They run at specific pipeline steps during platform operations
 - Filters can halt execution by raising exceptions
 - Multiple filters can be chained together in a pipeline
 - Filters should be lightweight and handle errors gracefully
@@ -56,18 +56,17 @@ class ChangeCourseAboutPageUrl(PipelineStep):
     This filter hooks into the course about page URL rendering process.
     Register it for the filter: org.openedx.learning.course.about.render.started.v1
 
-    Registration Example (in settings/common.py):
-    ```python
-    def plugin_settings(settings):
-        settings.OPEN_EDX_FILTERS_CONFIG = {
-            "org.openedx.learning.course.about.render.started.v1": {
-                "pipeline": [
-                    "sample_plugin.pipeline.ChangeCourseAboutPageUrl"
-                ],
-                "fail_silently": False,
+    Registration Example (in settings/common.py)::
+
+        def plugin_settings(settings):
+            settings.OPEN_EDX_FILTERS_CONFIG = {
+                "org.openedx.learning.course.about.render.started.v1": {
+                    "pipeline": [
+                        "sample_plugin.pipeline.ChangeCourseAboutPageUrl"
+                    ],
+                    "fail_silently": False,
+                }
             }
-        }
-    ```
 
     Filter Documentation:
     - Available Filters: https://docs.openedx.org/projects/openedx-filters/en/latest/reference/filters.html
@@ -100,7 +99,7 @@ def run_filter(self, url, org, **kwargs):
 
         Raises:
             FilterException: If processing should be halted
-            
+
         Filter Requirements:
         - Must return dictionary with keys matching input parameters
         - Return None to skip this filter (let other filters run)
@@ -121,14 +120,14 @@ def run_filter(self, url, org, **kwargs):
         match = re.search(pattern, url)
         if match:
             course_id = match.group('course_id')
-            
+
             # Example: Redirect to external marketing site
             new_url = f"https://example.com/new_about_page/{course_id}"
-            
+
             logger.debug(
                 f"Redirecting course about page for {course_id} from {url} to {new_url}"
             )
-            
+
             # Return modified data
             return {"url": new_url, "org": org}
 
@@ -137,17 +136,17 @@ def run_filter(self, url, org, **kwargs):
         return {"url": url, "org": org}
 
         # Alternative patterns for different business logic:
-        
+
         # Organization-based routing:
         # if org == "special_org":
         #     new_url = f"https://special-site.com/courses/{course_id}"
         #     return {"url": new_url, "org": org}
-        
+
         # Course type-based routing:
         # if "MicroMasters" in course_id:
         #     new_url = f"https://micromasters.example.com/{course_id}"
         #     return {"url": new_url, "org": org}
-        
+
         # A/B testing implementation:
         # import random
         # if random.choice([True, False]):

backend/sample_plugin/signals.py

@@ -85,34 +85,33 @@ def log_course_info_changed(signal, sender, catalog_info: CourseCatalogData, **k
     - Log changes for audit and compliance
     - Update analytics dashboards with new course information
 
-    Example Implementation:
-    ```python
-    # Send to external CRM system
-    external_api.update_course(
-        course_id=str(catalog_info.course_key),
-        name=catalog_info.name,
-        is_hidden=catalog_info.hidden
-    )
-
-    # Update internal tracking
-    CourseChangeLog.objects.create(
-        course_key=catalog_info.course_key,
-        change_type='catalog_updated',
-        timestamp=timezone.now()
-    )
-    ```
+    Example Implementation::
+
+        # Send to external CRM system
+        external_api.update_course(
+            course_id=str(catalog_info.course_key),
+            name=catalog_info.name,
+            is_hidden=catalog_info.hidden
+        )
+
+        # Update internal tracking
+        CourseChangeLog.objects.create(
+            course_key=catalog_info.course_key,
+            change_type='catalog_updated',
+            timestamp=timezone.now()
+        )
 
     Performance Considerations:
     - Keep processing lightweight (events should not block platform operations)
     - Use asynchronous tasks for heavy processing (Celery, etc.)
     - Handle exceptions gracefully to prevent platform disruption
     """
     logging.info(f"Course catalog updated: {catalog_info.course_key}")
-    
+
     # Access available data from the event
     logging.debug(f"Course name: {catalog_info.name}")
     logging.debug(f"Course hidden: {catalog_info.hidden}")
-    
+
     # Example: Integrate with external systems
     # try:
     #     # Send to external system
@@ -123,7 +122,7 @@ def log_course_info_changed(signal, sender, catalog_info: CourseCatalogData, **k
     #     )
     # except Exception as e:
     #     logging.error(f"Failed to notify external system: {e}")
-    
+
     # Example: Update internal tracking
     # from .models import CourseArchiveStatus
     # CourseArchiveStatus.objects.filter(