revamps docs complete

master-docs/20-api/ENDPOINTS/linker.md

@@ -0,0 +1,48 @@
+# Linker Endpoints
+
+## Purpose
+Document linker API endpoints for internal linking operations.
+
+## Code Locations (exact paths)
+- Routing: `backend/igny8_core/modules/linker/urls.py`
+- Views: `backend/igny8_core/modules/linker/views.py`
+- Services: `backend/igny8_core/business/linking/services/*`
+
+## High-Level Responsibilities
+- Provide linker-related endpoints (as defined in `LinkerViewSet`) for managing internal linking logic.
+
+## Detailed Behavior
+- Base path: `/api/v1/linker/`
+- Router registers root `LinkerViewSet` (see module code for actions/fields).
+- Inherits base viewset scoping, unified responses, permissions, throttling defined in module views.
+
+## Data Structures / Models Involved (no code)
+- Linking-related models/services (see business/linking).
+
+## Execution Flow
+- Requests → DRF auth → LinkerViewSet → service logic → unified response.
+
+## Cross-Module Interactions
+- May consume writer content to generate linking recommendations; interacts with linker services.
+
+## State Transitions
+- As defined by LinkerViewSet actions (not detailed in code snippet).
+
+## Error Handling
+- Standard unified responses and throttling.
+
+## Tenancy Rules
+- Inherits account/site scoping from base classes.
+
+## Billing Rules
+- None specified.
+
+## Background Tasks / Schedulers
+- None specified in endpoints.
+
+## Key Design Considerations
+- Endpoint actions rely on business/linking services; keep scoping intact.
+
+## How Developers Should Work With This Module
+- Extend LinkerViewSet/actions as needed; ensure base scoping and unified responses remain consistent.
+