fixup! fixup! fixup! fixup! fixup! fixup! fixup! fixup! fixup! fixup! fixup! fixup! fixup! fixup! fixup! Add a directives for general purpose documentation in downstream projects

Author: swrichards

django_setup_configuration/documentation/setup_config_usage.py

@@ -87,10 +87,11 @@ def run(self):
         step_sections: list[nodes.section] = []
         if show_steps:
             for step in steps:
-                step_node = nodes.section(ids=[step.anchor_id])
+                step_node = nodes.section(ids=[step.module_path])
                 step_node += nodes.title(text=step.title)
 
                 rst = ViewList()
+                rst.append(f".. _{step.anchor_id}:", "<dynamic>")
                 if show_steps_autodoc:
                     rst.append(f".. autoclass:: {step.module_path}", "<dynamic>")
                     rst.append("    :noindex:", "<dynamic>")
@@ -126,7 +127,7 @@ def _load_steps(self, configured_steps) -> list[StepInfo]:  # -> list:
             step_cls = import_string(step_path)
             step_info = StepInfo(
                 title=step_cls.verbose_name,
-                anchor_id=f"ref-step-{step_path}",
+                anchor_id=f"ref_step_{step_path}",
                 module_path=step_path,
                 step_cls=step_cls,
                 description=step_cls.__doc__ or "",