mirror of
https://github.com/langgenius/dify-docs.git
synced 2026-08-24 12:02:54 -04:00
Riskey
508d27f1c6
* docs: port the snippets page to the cloud tree (#899)
* docs: sync 1.16.x self-host page updates to the cloud tree (#900)
* docs: sync the go to anything rewrite to the cloud tree
* docs: sync MCP header and timeout docs to the cloud tools page
* docs: add input placeholder to the cloud web app settings page
* docs: document workflow log archiving and rewrite the logs pages (#924)
* docs: record the web app standard and new terms in the glossary (#904)
* docs: record web app, branding and new agent terms in the glossary
Standardize on web app / Web 应用 / Web アプリ, lowercase in English body
text, and say explicitly that naming a UI element takes the on-screen
label verbatim instead.
Correct two stale rows: AI Credits pointed at a dead i18n key, and the
Max Iterations ja column matched neither the node nor the app setting.
Add the Branding and Custom Frontend entry points, the web app access
levels and tabs, and the New Agent roster labels.
* docs: use integration trigger wording in the guides skill
* fix: match the AI credits glossary row to the UI casing
The UI Labels tables quote on-screen text verbatim, so the English column takes the lowercase the product renders. Align the two adjacent notes that referred to the old casing, and point the web app cross-reference at the UI Labels section, which is what the heading is actually called.
* fix: correct the audio-to-text spec and the api reference term (#903)
* fix: correct the audio-to-text errors and SSE example separators
Drop app_unavailable, provider_quota_exceeded and model_currently_not_support
from the /audio-to-text 400 list: no raise site reaches them on the path the
endpoint takes. provider_not_support_speech_to_text stays, since audio_service
raises it when the tenant has no default speech-to-text model. The endpoint
uses the workspace default model, not the app's configured one, so correct
that claim too.
Separate the events in the 10 space-joined SSE examples with blank lines,
matching the wire format the response descriptions already document.
Also render triggered_from's plugin source as Integration Trigger.
* docs: standardize the web app term in the api reference
Same rule as the rest of the docs: web app / Web 应用 / Web アプリ in
prose, capitalized where a sentence starts. The operation title
Get App WebApp Settings is left alone, because Mintlify derives the
published slug /api-reference/applications/get-app-webapp-settings from
it and 18 files link there, as are the getChatWebAppSettings operationId
and the WebAppSettingsResponse schema.
* fix: title-case the web app heading in the end-user identity guide
The heading is Title Case, so the term takes Web App there rather than the body-text lowercase. The anchor is unchanged, since both forms slug to api-users-and-web-app-users-stay-separate.
* docs: terminology, label and link cleanup across the docs (#901)
* docs: add the self-host prerequisite to the CLI pages
difyctl login 404s on a default self-hosted deployment because the
/openapi/v1/* surface ships disabled, and with only OPENAPI_ENABLED it
503s at approval. Name both flags before the sign-in steps. Dify Cloud
is unaffected. Also fixes six pre-existing blank-line violations after
code fences in the same pages.
* docs: complete the Integration Trigger rename in ja
The ja tree rendered the node as 統合トリガー in 27 places across 9 files,
while the product UI calls it インテグレーショントリガー. Adopt the UI string.
No inbound links pointed at the four headings whose anchors move.
* fix: repoint contact-sales links to the per-language forms
Enterprise Tips still linked the udify.app webapp. Point each language
at its own HubSpot sales form, per writing-guides/style-guide.md. The
udify.app/chat/abc123 placeholder in user-input.mdx is untouched.
* fix: correct card icons that never rendered
icon="scale" and icon="arrows-exchange" are not FontAwesome 6 names, so
the Legal Pages and Import & Export cards rendered with no icon at all.
Use scale-balanced and right-left.
* docs: use 应用 instead of 应用程序 in the zh docs
The glossary term for app is 应用. 191 occurrences of 应用程序 remained,
mostly in the monitor, workspace and publish trees. The zh UI is itself
split between the two, so this follows the glossary rather than the UI.
* fix: align UI labels and formatting with the product
Max Iterations on the Agent node matched the classic Agent app setting
instead of the node's own label; the ja column said 最大反復数 where the UI
says 最大反復回数. The Run Batch tab was バッチ実行 in a ja tutorial and
Batch Run in en. The tool YAML type list documented 6 of the 14 values
ToolParameterType accepts. Three zh Frame captions disagreed with their
alt text.
* docs: standardize the web app term across all three languages
Use web app / Web 应用 / Web アプリ, lowercase in English body text and
capitalized where a sentence, description or title-case caption starts.
The product UI is split across web app, Web App and WebApp in every
language, so there is no UI spelling to follow; the glossary now carries
the rule. zh also had a third variant, 网页应用, and ja had four missing
CJK-Latin spaces.
On-screen labels stay verbatim: Web App Access Control, the Web App
publish-panel section, Who can access web app. So do the API identifiers
Get App WebApp Settings, whose published slug 18 files link to, plus
getChatWebAppSettings and WebAppSettingsResponse.
The webapp family pages carry their other fixes in this commit too,
since those edits interleave with the term change line by line.
* fix: address review feedback on terminology and frontmatter
Make "web app" plural in the cheatsheet so it parallels "Endpoints" in the same list. Close the zh lesson-10 parenthesis with the full-width mark it was opened with. Add the missing zh description on both chatflow-webapp pages, where en and ja already had one.
The other four review comments asked for descriptions on pages whose en source also lacks one. Those are not translation gaps; they belong to the tree-wide frontmatter pass tracked as DC-58.
* fix: match AI credits to the casing the product uses
The UI renders the label lowercase (modelProvider.card.aiCreditsOption and selector.aiCredits); only the section header quotaLabel is all-caps. Lowercase the term in body prose and in the model-providers description, and leave the two Title Case headings alone.
Safe on every branch this backports to: the capitalized modelProvider.quota was pruned upstream in the commit first tagged 1.15.0, so 1.15.0 through 1.16.1 all carry the same lowercase strings.
* fix: repoint contact-sales links on the snippet pages (#902)
The Enterprise Tip on the snippet pages still linked the udify.app
webapp. Point each language at its own HubSpot sales form, per the
rule in writing-guides/style-guide.md.
* docs: rewrite logs pages with retention and archive coverage
Rewrite the Logs page for both audience copies in en/zh/ja, verified against the dify codebase and the Cloud production deploy config. Covers all Studio app types plus Agent Console sessions (self-host), the per-plan retention model and monthly archive CSV download on Cloud, and both scheduled cleanup mechanisms on self-host. The New Agent overview gains a closing note on where sessions collect.
* fix: correct archive storage descriptions in env reference
The archiver writes monthly Parquet bundles, not JSONL, and does not require BILLING_ENABLED. The export bucket holds temporary CSV export ZIPs and is safe to auto-expire with a lifecycle rule.
* chore: add log page UI labels to glossary and sync termbase
Adds the Archived logs and log-page label rows. The termbase regeneration also folds in drift from earlier glossary edits that were never synced.
* docs: encode moment-of-use editing patterns in writing guides
Sharpens Repeating the UI into the moment-of-use test, adds the navigation hand-holding and trap-promotion patterns, and scopes bold away from enum value lists.
* docs: refine logs pages from review feedback
Names the WEB APPS list on Home as the in-Dify usage surface, lists the Trigger By values with meanings, rewrites search and the hover actions task-first, adds a Test With Params screenshot, attributes test sessions to the team member's account, and makes the self-host retention section name the exact enable and retention-days variables for both log types with a note that cleanup is a scheduled daily task. The env reference's ENABLE_CLEAN_MESSAGES row now names SANDBOX_EXPIRED_RECORDS_RETENTION_DAYS as the window.
* docs: link the Logs page from the new agent overview
(cherry picked from commit abce6abc73)