release: promote release/1.15.0 to main#825
Merged
Merged
Conversation
Phase 1 of the audience-products restructure. Establishes two-product navigation using Mintlify's products primitive, with content moved into per-product paths so each product has its own URL space.
IA composition: languages > products > tabs > {groups | dropdowns | menu | pages}
Cloud product (3 tabs):
- Use Dify
- Developers (menu: API Reference, CLI)
- Plugin
Self-Hosted product (4 tabs):
- Use Dify (dropdowns: User Guide, Admin Guide [EE placeholder])
- Deploy (dropdowns: Community, Enterprise [EE placeholder])
- Developers (menu: API Reference with User API / Admin API dropdowns, CLI)
- Plugin
Filesystem reorganization (en/zh/ja parallel):
- use-dify, develop-plugin, api-reference moved into cloud/, copied into self-hosted/
- self-host moved into self-hosted/deploy/ce
- 9 misfit pages deleted per audit (subscription-management and knowledge-request-rate-limit removed from Self-Hosted; web-app-access removed from Cloud)
- Placeholder MDX for Admin Guide, EE Deploy, Admin API, CLI
Configuration:
- Theme: maple to luma
- Logo href: https://dify.ai
- Navbar: Blog link + Get Started primary button
References:
- Audit: audit/page-audience-classification.md
- Design: ~/Documents/Work/Drafts/2026-04-30-dify-docs-audience-products-design.md
- Progress: ~/Documents/Work/Drafts/2026-05-14-dify-docs-audience-products-progress.md
Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
All 6 duplicate-and-tailor pages in workspace/ split per audience: - readme.mdx - app-management.mdx - model-providers.mdx - personal-account-management.mdx - plugins.mdx - team-members-management.mdx Editorial principles applied throughout: - Filter out the wrong audience's content (Cloud removes env-var blocks, Self-Hosted removes subscription/billing references, etc.) - Don't restate the audience identity in body prose; address the reader directly since they're already in the product-specific docs tree Style guide updated with three paid-feature callout patterns: - Whole section is the paid feature: badge inline with heading, no callout - Paid feature within a mixed section: <Info> callout AFTER the target paragraph with explicit subject - Inline mention: inline <Badge> in the sentence Plan badges introduced: <Badge color="blue">Professional</Badge>, <Badge color="blue">Team</Badge>, <Badge color="blue">Enterprise</Badge>. Notable corrections from audit: - Multi-workspace creation is Enterprise Edition only (not a default capability). Cloud accounts each create one workspace. - Dify Cloud has Sandbox/Pro/Team only; no Cloud Enterprise plan. "Enterprise" always refers to Self-Hosted EE. - System Providers (Dify-managed) concept removed from Self-Hosted entirely; only custom providers exist there. Agent-dispatched flow surfaced audience markers the audit missed on personal-account-management.mdx (4 additional markers) and team-members-management.mdx (2 additional markers). Reference: ~/Documents/Work/Drafts/2026-05-14-dify-docs-audience-products-progress.md Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
Diverge the seven Knowledge pages with audience-specific markers into Cloud and Self-Hosted versions: - chunking-and-cleaning-text: remove Summary Auto-Gen from Cloud (Self-Hosted-only); drop self-hosted framing - import-text-data/readme: Cloud uses Pro+Team plan-tier callout for the 50-file batch limit; Self-Hosted inlines env vars (UPLOAD_FILE_BATCH_LIMIT, UPLOAD_FILE_SIZE_LIMIT, etc.) - sync-from-notion: Cloud notes pre-configured OAuth; Self-Hosted retains manual OAuth setup with standardized headings and env-var fixes - setting-indexing-methods: Cloud drops Q&A indexing subsection; Self-Hosted drops "self-hosted only" qualifier - knowledge-pipeline-orchestration: Cloud reframes batch table as plan-scoped; Self-Hosted uses verified docker env defaults (BATCH_UPLOAD_LIMIT removed as Pydantic-only) - publish-knowledge-pipeline: Cloud uses Pro+Team callout for Sandbox restriction; Self-Hosted removes the restriction entirely - maintain-knowledge-documents: Cloud keeps auto-disable schedule and Add Chunks paid callout; Self-Hosted keeps Generate Summary unframed Also rewrite 22 cross-reference links across the affected files from /en/use-dify/ to product-prefixed /en/cloud/ or /en/self-hosted/ paths, and from /en/develop-plugin/ to the product-prefixed equivalents. Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
Diverge the five Workflow node pages with audience-specific markers into Cloud and Self-Hosted versions: - code: Cloud removes the Self-Hosted Setup section; Self-Hosted renames it to Sandbox Service, corrects stale output-limit defaults (e.g., 80,000 to 400,000) against CODE_* env vars verified in dify/docker/envs/core-services/shared.env.example, and removes the Cloudflare WAF Frame - knowledge-retrieval: Cloud reframes rate limits as subscription-plan behavior; Self-Hosted removes plan content and surfaces ATTACHMENT_IMAGE_FILE_SIZE_LIMIT inline - trigger/overview: Cloud uses Scenario 2 callouts for the Sandbox 2-trigger limit and execution quotas; Self-Hosted removes all plan-tier content - trigger/plugin-trigger: Cloud keeps Default/Custom OAuth nested tabs; Self-Hosted collapses to Custom-only and promotes scattered TRIGGER_URL callouts into one Prerequisite section - trigger/webhook-trigger: Cloud folds TRIGGER_URL into an inline sentence; Self-Hosted keeps the env var and surfaces the default http://localhost Cross-reference links across the affected files updated from /en/use-dify/ to product-prefixed paths. Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
…er audience Consolidates three previously-split commits that have been reverted for review. This single commit makes the changes easier to review in one place; the granular three-commit version is preserved on backup/audience-products-pre-revert if needed. Includes: - Rename the Self-Hosted product path slug from self-hosted to self-host across en, zh, and ja product trees (505 file renames). docs.json navigation entries and internal MDX cross-reference links updated to match. Display name "Self-Hosted" and glossary term unchanged. Legacy /getting-started/install- self-hosted redirects preserved. - Tailor 7 Getting Started + Build pages per audience. Cloud versions drop self-hosted env-var blocks; Self-Host versions inline the verified docker-env defaults from dify/docker/envs/core-services/shared.env.example (UPLOAD_FILE_SIZE_LIMIT, UPLOAD_IMAGE_FILE_SIZE_LIMIT, UPLOAD_AUDIO_FILE_SIZE_ LIMIT, ENABLE_COLLABORATION_MODE, SERVER_WORKER_CLASS, NEXT_PUBLIC_SOCKET_URL). Getting Started quick-start restructured per audience: Cloud signup with AI Credits; Self-Host deploy + sign in + bring-your-own model provider. - Tailor 7 Monitor + Publish + Tutorials pages per audience. monitor/logs gets a Scenario 2 plan-tier callout on Cloud; web-app-settings removes the EE access-control section on Cloud and keeps it with an Enterprise badge on Self-Host; integration version-floor callouts dropped from Cloud and rephrased product-neutrally on Self-Host. Also includes: - docs.json: metadata.timestamp = true (user edit) - en/cloud/use-dify/getting-started/quick-start.mdx: simplified Sign Up step intro Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
Flatten the self-host deploy tree by removing the intermediate `ce` segment, moving quick-start, configuration, advanced-deployments, platform-guides, and troubleshooting up to `self-host/deploy/` across en, zh, and ja. Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
Move tutorials out of each product's use-dify section into a shared `{lang}/tutorials/` tree referenced by both Cloud and Self-Host, and remove the per-product copies and the tutorial snippets.
Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
Replace the duplicated per-product getting-started key-concepts and quick-start pages with single shared `{lang}/key-concepts` and `{lang}/quick-start` pages. The quick start is product-neutral: it uses the Cloud fast path with a callout pointing self-hosters to deployment.
Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
Bring in changes merged to main since the branch point: API reference and plugin development updates, the plugin sidebar reorganization with a new choose-plugin-type page, backport tooling, workflow node content updates, and refreshed skill, glossary, and translation config files. Content updates are applied to both Cloud and Self-Host copies and to zh and ja. Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
Reorganize each product's tabs into a consistent verb set (Use, Deploy, Learn, Develop), with Deploy placed second for Self-Host. Nest the plugin docs under the Develop dropdown and rename its items to API, CLI, and Plugins. Elevate each product's Introduction to the Use tab's front-door Overview, and remove the unused placeholder pages. Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
Repair malformed markdown links in the Langfuse and API Extension pages where the link target had been replaced by NUL bytes, restoring the langfuse.com and ngrok.com links. The corruption had caused text tools to treat these pages as binary files. Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
Convert the AI-translation disclaimer at the top of every zh and ja page from a Note callout to a lightweight blockquote, dropping the warning emoji while keeping each page's link to its English source. Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
Root index.mdx in custom mode routing visitors to Quick Start, Dify Cloud, Self-Host deployment, and shared developer resources. The tab row is hidden on the landing only via a path-scoped style.css rule. Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
Self-hosters' first task is standing up the instance, so the Self-Host product now opens on Deploy instead of Use, in all three languages. Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
17 links in 15 pages still pointed at the pre-restructure
self-host/{group} paths after the deploy/ce segment removal.
Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
Orientation page as the Deploy tab's front door: deployment method cards, post-deployment pointers, release notes link, and the EE tip. The root landing's Self-Host card now points here. Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
The introductions carried site-landing content (Quick Start, Forum, Changelog cards) from before the root landing existed. They now orient within the Use tab: section cards for Build, Knowledge, Publish, Monitor, and Workspace, plus a learning pointer for newcomers. Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
The forum is being taken offline. Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
27 new rules map the published structure to the new one: use-dify to cloud, self-host groups into deploy/, tutorials and key-concepts and quick-start to shared trees. The 178 legacy redirect destinations pointing at moved paths are rewritten to final targets to avoid chains, and two broken legacy destinations are fixed. web-app-access is intentionally left without a redirect until its EE docs path exists. Validated by simulating all 748 live sitemap URLs through the rules. Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
The CLOUD badge predates the product split; inside the Cloud product it labels nothing. Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
Both overview types now share one composition: a two-column hero (orientation line, primary CTA, quiet secondary links, screenshot on the Use pages) and a grid of six equal cards ending in a Get Help card with Discord, GitHub Issues, and Discussions links. Layout CSS is a shared .uo-* family in style.css; the grid self-adapts between five and six items. Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
All EE contact-sales callouts now link to the sales chat at udify.app/chat/QuwcpW1oBNcfeL55. Plan-upgrade and plan-comparison links deliberately keep dify.ai/pricing. Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
Adds a `--compare-rev OLD NEW --repo <dify> [--docs]` mode to verify-env-docs.py: it diffs the full .env.example variable set between two git refs and flags new variables still undocumented and not in ignored-vars.md. Documented in the env-vars skill as the first step of a release sync, to catch variables added by untagged PRs that per-PR detection misses.
* docs: add difyctl CLI documentation Adds the difyctl doc set under Self-Host > Developer Resources > CLI (en/cli/), Community Edition only for the CE-first launch; the Cloud nav does not reference the CLI yet. - Aligns the version reference with the 1.15.0 compat window and alpha channel (PR #37794). - Keeps command-reference Examples command-only, with output in the Output section. Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com> * translate: add zh/ja Dify CLI documentation Adds Chinese and Japanese translations of the difyctl CLI doc set (20 pages each) under zh/cli/ and ja/cli/, and registers them in the zh/ja docs.json navigation (CLI under the Self-Host product only, mirroring the English structure). Removes the zh/ja coming-soon placeholders. Hand-translated following tools/translate/formatting-zh.md, formatting-ja.md, and the terminology base, then audited with the format and terminology checks. Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com> * Apply suggestions from code review Co-authored-by: Copilot Autofix powered by AI <175728472+Copilot@users.noreply.github.com> * fix: restore version --short row, align zh env-vars flag section - version.mdx (zh/ja): restore the --short flag row removed by accident - environment-variables.mdx (zh): the env list flag section was rendered as 参数 (Arguments); use 标志 (Flags) for the heading and table header, matching the other reference pages --------- Co-authored-by: Claude Opus 4.8 (1M context) <noreply@anthropic.com> Co-authored-by: Copilot Autofix powered by AI <175728472+Copilot@users.noreply.github.com>
The navigation refactor split the workspace section into Integrations and Workspace, but the Use overview still carded only Workspace and listed model providers under it. Add an Integrations card linking to the hub and drop the sparse Workspace card. Self-host only; Cloud keeps its combined Workspace section. Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
Register the event in the chatflow and workflow specs (schema, enum, discriminator, and inline examples), add resumed-run streaming examples to the Stream Workflow Events endpoints, and make top-level created_at consistent across the chatflow streaming examples.
Translate the LLM node reasoning section and the reasoning_chunk API additions for zh and ja. Also corrects pre-existing broken hyphenated api-reference cross-links in the zh workflow spec.
Restore the en/zh/ja pages at the cloud/ path the split redirect targets, so the old /use-dify/ URLs resolve instead of 404ing. Kept out of docs.json so they stay unlisted; temporary until they move to the EE repo.
dosubot
Bot
added
size:XXL
This was referenced Jun 25, 2026
- Add a prerequisite note: difyctl requires Dify 1.15.0 or later - Reframe version matching around DIFY_VERSION (drop the circular difyctl version check) - Consolidate the three install env vars into one options table
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
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.
Cut over to the 1.15.0 audience-products restructure; main's prior commits are superseded by release content.
Close #817, #818, #787, #779