Remove blog slugs and use redirects for docs-chatbot compatibility #255
Conversation
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
jordanstephens
approved these changes
Jul 15, 2025
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
Add this suggestion to a batch that can be applied as a single commit.
This suggestion is invalid because no changes were made to the code.
Suggestions cannot be applied while the pull request is closed.
Suggestions cannot be applied while viewing a subset of changes.
Only one suggestion per line can be applied in a batch.
Add this suggestion to a batch that can be applied as a single commit.
Applying suggestions on deleted lines is not supported.
You must change the existing code in this line in order to create a valid suggestion.
Outdated suggestions cannot be applied.
This suggestion has been applied or marked resolved.
Suggestions cannot be applied from pending reviews.
Suggestions cannot be applied on multi-line comments.
Suggestions cannot be applied while the pull request is queued to merge.
Suggestion cannot be applied right now. Please check back later.
Remove blog slugs and add redirects instead for compatibility with docs-chatbot link parsing.
Currently, if you add a custom slug to a blog, the docs-chatbot (i.e. Ask Defang) will provide an incorrect link to that blog in its list of references because the link is auto-generated based on the file name. For example, if the file name in the repo is
2025-06-16-crew-ai-sample.md, the docs-chatbot will generate the link using the formula that changes dates to slashes and uses the exact file name, such as2025/06/16-crew-ai-sample. If you use a slug such asrag-agents-crew-ai-sample, then the docs-chatbot will not be able to point to that link ending because it only knows the auto-generated link.I would suggest using redirects in the
docusaurus.config.jsfile to redirect a user to a particular link as an alternative to slugs for better compatibility with the chatbot in its current state.