Documentation should be kept authoritative and maintainable: use stable links, avoid recommending deprecated APIs, and remove misleading/ineffective documentation details. Apply it as follows: - Prefer stable/canonical URLs (often relative) for “view tutorial” links; don’t pin to a specific external commit hash. - Keep examples focused on the intended surface area. If documenting a tool, show tool usage (e.g., `tool.invoke(...)`) rather than agent-creation workflows. - Remove or avoid examples of deprecated functionality. - Don’t document schema/config values that are ineffective for the given type (e.g., an array `default` that provides no value in JSON Schema). Example (tool-only, non-deprecated usage): ```python from langchain_desearch.tools import DesearchTool tool = DesearchTool() result = tool.invoke({"query": "LLM RAG best practices"}) print(result) ```