docs: add configuration for automatic filters docs generation (#173)

CHANGELOG.rst

@@ -13,6 +13,7 @@ Change Log
 
 Unreleased
 ----------
+* Configuration for automatic filters docs generation.
 
 [1.9.0] - 2024-06-14
 --------------------

docs/conf.py

@@ -10,10 +10,9 @@
 # add these directories to sys.path here. If the directory is relative to the
 # documentation root, use os.path.abspath to make it absolute, like shown here.
 #
-# import os
-# import sys
-# sys.path.insert(0, os.path.abspath('.'))
-
+import os
+import sys
+sys.path.insert(0, os.path.abspath('..'))
 
 # -- Project information -----------------------------------------------------
 
@@ -35,6 +34,8 @@
     'sphinx_copybutton',
     'sphinx.ext.graphviz',
     'sphinxcontrib.mermaid',
+    'sphinx.ext.autodoc',
+    'sphinx.ext.autosummary',
 ]
 
 # Add any paths that contain templates here, relative to this directory.

docs/reference/filters.rst

@@ -0,0 +1,10 @@
+Filters
+=======
+
+This is the list of Open edX Filters found in this repository.
+
+.. note::
+    Filters can be created in other projects and plugins as well, but these default filters are guaranteed to exist.
+
+.. automodule:: openedx_filters.learning.filters
+   :members:

docs/reference/index.rst

@@ -5,4 +5,5 @@ References
    :maxdepth: 1
    :caption: Contents:
 
+   filters
    django-plugins-and-filters