AI module documentation has warnings when running mkdocs serve

Created on 28 July 2025, 5 days ago

Problem/Motivation

Errors when running mkdocs serve locally:

WARNING -  A reference to 'modules/ai_assistant_api/#ai-chatbot-module' is included in the 'nav' configuration, which is not found in the documentation files.
WARNING -  A reference to 'contribute/issue_guidelines.md' is included in the 'nav' configuration, which is not found in the documentation files.
INFO    -  Doc file 'developers/ddev.md' contains an absolute link '/modules/providers/provider_ollama/', it was left as is.
INFO    -  Doc file 'developers/ddev.md' contains an absolute link '/modules/vdb_providers/vdb_provider_milvus/#using-with-ddev', it was left as is.
INFO    -  Doc file 'developers/develop_api_assistant_action.md' contains an unrecognized relative link '../modules/ai_search/', it was left as is. Did you mean
           '../modules/ai_search/index.md'?
INFO    -  Doc file 'modules/ai_assistant_api/index.md' contains an unrecognized relative link '../ai_search/', it was left as is. Did you mean '../ai_search/index.md'?
WARNING -  Doc file 'modules/ai_assistant_api/index.md' contains a link 'developers/develop_api_assistant_action.md', but the target
           'modules/ai_assistant_api/developers/develop_api_assistant_action.md' is not found among documentation files.

Steps to reproduce (required for bugs, but not feature requests)

Please provide information like AI modules enabled, which AI provider, browser, etc.

Follow instructions for running docs locally:

https://project.pages.drupalcode.org/ai/1.1.x/documentation/

Proposed resolution

Update the documentation to get rid of the warnings :)

Remaining tasks

Update docs, review, merge

Optional: Other details as applicable (e.g., User interface changes, API changes, Data model changes)

πŸ› Bug report
Status

Active

Version

1.2

Component

Documentation

Created by

πŸ‡ΊπŸ‡ΈUnited States Kristen Pol Santa Cruz, CA, USA

Live updates comments and jobs are added and updated live.
Sign in to follow issues

Merge Requests

Comments & Activities

Production build 0.71.5 2024