What’s broken?

The documentation does not explain how to control grouping or ordering of items in the slash (suggestion) menu, even though this functionality is supported by the API.

Developers discovering this feature cannot reasonably figure out:
• how grouping works,
• how to reuse an existing group instead of creating duplicates, or
• how to reorder items within or across groups.

This leads to confusion and the impression that the functionality is missing or unsupported.

What did you expect to happen?

The documentation should clearly describe:
• how suggestion menu items are grouped,
• how to combine multiple item sources into shared groups,
• how to control ordering within groups,
• and provide a minimal, working example demonstrating this behavior.

This would allow developers to use the feature without digging through source code or examples.

Steps to reproduce

1. Search the documentation for guidance on grouping or ordering.
2. Observe that the relevant APIs and patterns are not documented.

BlockNote version

No response

Environment

No response

Additional context

See: #2420 (comment)

Contribution

• I'd be interested in contributing a fix for this issue

Sponsor

• I'm a sponsor and would appreciate if you could look into this sooner than later 💖