Improve search documentation

[handotdev]

Enhanced search documentation with comprehensive configuration details, best practices, and API usage guidance. Added detailed explanations of search functionality, indexing behavior, keyboard shortcuts, and optimization tips.

Files changed:

• organize/settings.mdx - Added search functionality section with indexing details and best practices
• api/assistant/search.mdx - Expanded API documentation with use cases, behavior details, and implementation guidance

---

Note

Medium Risk
Medium risk because it changes shared linting/styling configuration (.vale.ini and custom rules) and updates the Admin API OpenAPI spec with new v2 endpoints, which can affect documentation builds and downstream API consumers.

Overview
Expands Claude/Mintlify documentation automation assets by restructuring .claude-plugin/marketplace.json (adds doc-reader, doc-helper, doc-author alongside doc-reviewer) and adding multiple new .claude/skills/* references plus new .mintlify/workflows/* scheduled workflow definitions.

Updates authoring/review guidance by revising .claude/CLAUDE.md (context/tooling rules, submission checklists) and tightening command descriptions in .claude/commands/* (notably lint-docs switching to mint validate).

Refreshes linting rules and vocabulary by switching Vale to Mintlify-derived styles, adding new custom rules (e.g., Headings, FirstPerson, Slang, Will), and significantly expanding the accepted vocabulary list; removes some Google style rules and Locadex files.

Adds/updates product docs and specs by introducing new MDX pages for the agent (Slack/Linear/Notion, prompts, customization, use cases) and advanced-support.mdx, and by updating admin-openapi.json to version 2.0.0 with server URL changes, deprecated v1 agent endpoints under /v1, and new async v2 job/message endpoints plus shared schemas.

^{Reviewed by Cursor Bugbot for commit 415d512. Bugbot is set up for automated code reviews on this repo. Configure here.}

[ethanpalm]

closing this since I messed up the rebase 🙃 will update in a separate PR

[cursor]

Cursor Bugbot has reviewed your changes and found 1 potential issue.

^{❌ Bugbot Autofix is OFF. To automatically fix reported issues with cloud agents, enable autofix in the Cursor dashboard.}

^{Reviewed by Cursor Bugbot for commit 415d512. Configure here.}

[cursor]

Plugin references nonexistent skill directory

Medium Severity

The doc-helper plugin definition at line 48 references ./.claude/skills/doc-helper/ as its skills path, but this directory does not exist. The .claude/skills/ directory only contains doc-author, doc-reader, mintlify, and update-nav. The other new plugins (doc-reader, doc-author) each have corresponding skill directories and SKILL.md files added in this commit, but doc-helper was not created.

 

^{Reviewed by Cursor Bugbot for commit 415d512. Configure here.}