langgenius/dify-docs
1
0
Fork 0
mirror of https://github.com/langgenius/dify-docs.git synced 2026-07-22 04:15:24 -04:00
Code Issues 10 Packages Projects Releases Wiki Activity

[DOCS]: Broken Links in #288

New Issue
Closed
opened 2026-02-16 05:19:45 -05:00 by yindo · 2 comments
yindo commented 2026-02-16 05:19:45 -05:00
Owner
Copy Link
Copy Source

Originally created by @QuantumGhost on GitHub (Dec 8, 2025).

Type of Documentation Change

Error/Typo fix

Documentation Page URL or Path

No response

Current Content

Links to the quick start guides in the Plugin Development section of README.md are all broken.

Example:

The Quick Start: Model Plugin URL points to the page with URL https://docs.dify.ai/en/plugins/quick-start/develop-plugins/model-plugin/README. Requests to the url get redirected to https://docs.dify.ai/en/develop-plugin/0111-getting-started-dify-plugin, which responds a 404 Page Not Found error.

Screenshot:

Image

Other links to quick start guides are broken, too.

ref: https://github.com/langgenius/dify-plugins/issues/1688

Suggested Changes

Fix the broken links in plugin development guide, or redirect requests to those urls to correct pages.

Reason for Change

No response

Code of Conduct

  • I agree to follow Dify's documentation contribution guidelines
  • I have searched for existing issues search for existing issues, including closed ones.
  • I confirm that I am using English to submit this report, otherwise it will be closed.
  • 【中文用户 & Non English User】请使用英语提交，否则会被关闭 ：）
  • Please do not modify this template :) and fill in all the required fields.
Originally created by @QuantumGhost on GitHub (Dec 8, 2025). ### Type of Documentation Change Error/Typo fix ### Documentation Page URL or Path _No response_ ### Current Content Links to the quick start guides in the [Plugin Development](https://github.com/langgenius/dify-plugins?tab=readme-ov-file#plugin-development) section of README.md are all broken. Example: The [Quick Start: Model Plugin](https://docs.dify.ai/en/plugins/quick-start/develop-plugins/model-plugin/README) URL points to the page with URL `https://docs.dify.ai/en/plugins/quick-start/develop-plugins/model-plugin/README`. Requests to the url get redirected to `https://docs.dify.ai/en/develop-plugin/0111-getting-started-dify-plugin`, which responds a `404 Page Not Found` error. Screenshot: <img width="1505" height="779" alt="Image" src="https://github.com/user-attachments/assets/8f2ecad1-804d-4e44-b4c1-a57cd131d482" /> Other links to quick start guides are broken, too. ref: https://github.com/langgenius/dify-plugins/issues/1688 ### Suggested Changes Fix the broken links in plugin development guide, or redirect requests to those urls to correct pages. ### Reason for Change _No response_ ### Code of Conduct - [x] I agree to follow Dify's documentation [contribution guidelines](https://github.com/langgenius/dify/blob/0277a37fcad5ad86aeb239485c27fffd5cd90043/CONTRIBUTING.md) - [x] I have searched for existing issues [search for existing issues](https://github.com/langgenius/dify/issues), including closed ones. - [x] I confirm that I am using English to submit this report, otherwise it will be closed. - [x] 【中文用户 & Non English User】请使用英语提交，否则会被关闭 ：） - [x] Please do not modify this template :) and fill in all the required fields.
yindo added the documentation label 2026-02-16 05:19:45 -05:00
yindo closed this issue 2026-02-16 05:19:45 -05:00
yindo commented 2026-02-16 05:19:45 -05:00
Author
Owner
Copy Link
Copy Source

@dosubot[bot] commented on GitHub (Dec 8, 2025):

The broken quick start guide links in the Plugin Development section are due to a recent documentation restructure. The correct URLs are now under /en/develop-plugin/ instead of the old /en/plugins/quick-start/develop-plugins/ paths. For example, the Model Plugin quick start should point to /en/develop-plugin/features-and-specs/plugin-types/model-schema, and the main getting started guide is at /en/develop-plugin/getting-started/getting-started-dify-plugin citation.

Redirects are configured for legacy URLs, but some (like those pointing to /en/develop-plugin/0111-getting-started-dify-plugin) currently result in 404 errors. To fix this, update the README and any other docs to reference the new URLs directly rather than relying on redirects, which may become outdated citation.

Here are some of the updated quick start guide URLs:

Updating the links in your documentation to these new paths should resolve the issue.

To reply, just mention @dosu.

How did I do? Good | Irrelevant | Incorrect | Verbose | Hallucination | Report 🐛 | Other

Open in Cursor Join Discord Share on X

@dosubot[bot] commented on GitHub (Dec 8, 2025): <!-- Answer --> The broken quick start guide links in the Plugin Development section are due to a recent documentation restructure. The correct URLs are now under /en/develop-plugin/ instead of the old /en/plugins/quick-start/develop-plugins/ paths. For example, the Model Plugin quick start should point to [/en/develop-plugin/features-and-specs/plugin-types/model-schema](https://docs.dify.ai/en/develop-plugin/features-and-specs/plugin-types/model-schema), and the main getting started guide is at [/en/develop-plugin/getting-started/getting-started-dify-plugin](https://docs.dify.ai/en/develop-plugin/getting-started/getting-started-dify-plugin) [citation](https://github.com/langgenius/dify-docs/blob/cc7d905db73e0abe73564203f104921e6b294072/docs.json#L291-L4568). Redirects are configured for legacy URLs, but some (like those pointing to /en/develop-plugin/0111-getting-started-dify-plugin) currently result in 404 errors. To fix this, update the README and any other docs to reference the new URLs directly rather than relying on redirects, which may become outdated [citation](https://github.com/langgenius/dify-docs/pull/581). Here are some of the updated quick start guide URLs: - Getting Started: [/en/develop-plugin/getting-started/getting-started-dify-plugin](https://docs.dify.ai/en/develop-plugin/getting-started/getting-started-dify-plugin) - CLI Guide: [/en/develop-plugin/getting-started/cli](https://docs.dify.ai/en/develop-plugin/getting-started/cli) - Tool Plugin: [/en/develop-plugin/dev-guides-and-walkthroughs/tool-plugin](https://docs.dify.ai/en/develop-plugin/dev-guides-and-walkthroughs/tool-plugin) - Model Plugin: [/en/develop-plugin/dev-guides-and-walkthroughs/creating-new-model-provider](https://docs.dify.ai/en/develop-plugin/dev-guides-and-walkthroughs/creating-new-model-provider) - Agent Strategy: [/en/develop-plugin/features-and-specs/advanced-development/reverse-invocation](https://docs.dify.ai/en/develop-plugin/features-and-specs/advanced-development/reverse-invocation) Updating the links in your documentation to these new paths should resolve the issue. <!-- Dosu Comment Footer --> *To reply, just mention [@dosu](https://go.dosu.dev/dosubot).* --- <sup>How did I do? [Good](https://app.dosu.dev/response-feedback/a6cf1f23-790c-4bee-ab66-3f0bf9907755?feedback_type=great_response) | [Irrelevant](https://app.dosu.dev/response-feedback/a6cf1f23-790c-4bee-ab66-3f0bf9907755?feedback_type=irrelevant_answer) | [Incorrect](https://app.dosu.dev/response-feedback/a6cf1f23-790c-4bee-ab66-3f0bf9907755?feedback_type=incorrect_sources) | [Verbose](https://app.dosu.dev/response-feedback/a6cf1f23-790c-4bee-ab66-3f0bf9907755?feedback_type=too_verbose) | [Hallucination](https://app.dosu.dev/response-feedback/a6cf1f23-790c-4bee-ab66-3f0bf9907755?feedback_type=hallucination) | [Report 🐛](https://app.dosu.dev/response-feedback/a6cf1f23-790c-4bee-ab66-3f0bf9907755?feedback_type=bug_report) | [Other](https://app.dosu.dev/response-feedback/a6cf1f23-790c-4bee-ab66-3f0bf9907755?feedback_type=other)</sup> [![Open in Cursor](https://dosu.dev/dosu-in-cursor.svg)](https://cursor.com/link/prompt?text=The%20broken%20quick%20start%20guide%20links%20in%20the%20Plugin%20Development%20section%20are%20due%20to%20a%20recent%20documentation%20restructure.%20The%20correct%20URLs%20are%20now%20under%20/en/develop-plugin/%20instead%20of%20the%20old%20/en/plugins/quick-start/develop-plugins/%20paths.%20For%20example%2C%20the%20Model%20Plugin%20quick%20start%20should%20point%20to%20%5B/en/develop-plugin/features-and-specs/plugin-types/model-schema%5D%28https%3A//docs.dify.ai/en/develop-plugin/features-and-specs/plugin-types/model-schema%29%2C%20and%20the%20main%20getting%20started%20guide%20is%20at%20%5B/en/develop-plugin/getting-started/getting-started-dify-plugin%5D%28https%3A//docs.dify.ai/en/develop-plugin/getting-started/getting-started-dify-plugin%29%C2%A0%5Bcitation%5D%28https%3A//github.com/langgenius/dify-docs/blob/cc7d905db73e0abe73564203f104921e6b294072/docs.json%23L291-L4568%29.%0A%0ARedirects%20are%20configured%20for%20legacy%20URLs%2C%20but%20some%20%28like%20those%20pointing%20to%20/en/develop-plugin/0111-getting-started-dify-plugin%29%20currently%20result%20in%20404%20errors.%20To%20fix%20this%2C%20update%20the%20README%20and%20any%20other%20docs%20to%20reference%20the%20new%20URLs%20directly%20rather%20than%20relying%20on%20redirects%2C%20which%20may%20become%20outdated%C2%A0%5Bcitation%5D%28https%3A//github.com/langgenius/dify-docs/pull/581%29.%0A%0AHere%20are%20some%20of%20the%20updated%20quick%20start%20guide%20URLs%3A%0A-%20Getting%20Started%3A%20%5B/en/develop-plugin/getting-started/getting-started-dify-plugin%5D%28https%3A//docs.dify.ai/en/develop-plugin/getting-started/getting-started-dify-plugin%29%0A-%20CLI%20Guide%3A%20%5B/en/develop-plugin/getting-started/cli%5D%28https%3A//docs.dify.ai/en/develop-plugin/getting-started/cli%29%0A-%20Tool%20Plugin%3A%20%5B/en/develop-plugin/dev-guides-and-walkthroughs/tool-plugin%5D%28https%3A//docs.dify.ai/en/develop-plugin/dev-guides-and-walkthroughs/tool-plugin%29%0A-%20Model%20Plugin%3A%20%5B/en/develop-plugin/dev-guides-and-walkthroughs/creating-new-model-provider%5D%28https%3A//docs.dify.ai/en/develop-plugin/dev-guides-and-walkthroughs/creating-new-model-provider%29%0A-%20Agent%20Strategy%3A%20%5B/en/develop-plugin/features-and-specs/advanced-development/reverse-invocation%5D%28https%3A//docs.dify.ai/en/develop-plugin/features-and-specs/advanced-development/reverse-invocation%29%0A%0AUpdating%20the%20links%20in%20your%20documentation%20to%20these%20new%20paths%20should%20resolve%20the%20issue.)&nbsp;[![Join Discord](https://img.shields.io/badge/join-5865F2?logo=discord&logoColor=white&label=)](https://go.dosu.dev/discord-bot)&nbsp;[![Share on X](https://img.shields.io/badge/X-share-black)](https://twitter.com/intent/tweet?text=%40dosu_ai%20helped%20me%20solve%20this%20issue!&url=https%3A//github.com/langgenius/dify-docs/issues/598)
yindo commented 2026-02-16 05:19:45 -05:00
Author
Owner
Copy Link
Copy Source

@RiskeyL commented on GitHub (Dec 10, 2025):

This issue has been resolved by PR #1692 in the Dify Plugin repository.

@RiskeyL commented on GitHub (Dec 10, 2025): This issue has been resolved by [PR #1692](https://github.com/langgenius/dify-plugins/pull/1692) in the Dify Plugin repository.
Sign in to join this conversation.
No Branch/Tag Specified
Branches Tags
Labels
Clear labels
bug
documentation
documentation
enhancement
pull-request
Mirrored from GitHub Pull Request
 question
stale
No Label documentation
Milestone
No items
No Milestone
Projects
Clear projects
No project
Assignees
Clear assignees
yindo
No Assignees
1 Participants
Notifications
Due Date
No due date set.
Dependencies

No dependencies set.

Reference: langgenius/dify-docs#288
Delete Branch "%!s()"

Deleting a branch is permanent. Although the deleted branch may continue to exist for a short time before it actually gets removed, it CANNOT be undone in most cases. Continue?