## Problem/motivation Follow-up to: #3586258+s Parent: #3586298+s **6. Documentation And API Consistency** **Priority:** High to Medium **Why group these together:** These are low-risk docs/code consistency fixes that prevent contributors from copying stale API names or relying on a fallback that differs from install defaults. Includes: - Disabled select replacements. - Help list render arrays. - Table captions. - Emoji warning cleanup. ## Solution ### 6.1 Align the default context prefix **Files:** - `config/install/ai_context.settings.yml` - `src/EventSubscriber/AiContextSystemPromptSubscriber.php` - `docs/developers/events.md` - any settings/configuration docs that mention the default **Problem:** The install config and docs use: ```text The following site-specific context applies to this task. Use it strictly when relevant; do not override user intent. ``` The subscriber fallback uses different wording: ```text The following context applies to this task. Use it strictly when relevant. Do not override user intent. ``` **Recommended fix:** - Choose one canonical default string. - Prefer avoiding a divergent hardcoded fallback if config schema already requires a non-empty value. - Update docs and tests that assert the default. ### 6.2 Replace stale `getManageUrl()` documentation **Files:** - `docs/developers/scope_api.md` - `docs/developers/custom_scopes.md` **Problem:** Docs reference `getManageUrl()`, but current code uses `getManageRoute()` and `getManageLabel()`. **Recommended fix:** - Replace `getManageUrl()` with `getManageRoute()`. - Document the expected route array shape. - Keep `getManageLabel()` documentation. - Add a small example matching current plugin code. ### 6.3 Decide whether to add module help **Files:** - `ai_context.module` - README/docs as needed **Problem:** No `hook_help()` implementation exists. This is not necessarily a bug, but Drupal admin users may expect help text at `/admin/help/ai_context`. **Recommended fix:** - Maintainers should decide whether admin help is in scope. - If yes, add concise help that links to the existing docs rather than duplicating them. --- ## AI usage - [x] AI assisted issue