Skip to content

Clarify Arize and Phoenix integration positioning - #948

Open
arizedatngo wants to merge 2 commits into
langgenius:mainfrom
arizedatngo:arize-docs-positioning
Open

Clarify Arize and Phoenix integration positioning#948
arizedatngo wants to merge 2 commits into
langgenius:mainfrom
arizedatngo:arize-docs-positioning

Conversation

@arizedatngo

@arizedatngo arizedatngo commented Aug 18, 2026

Copy link
Copy Markdown

Summary

  • Clarifies the Dify integration pages for Arize AX and Arize Phoenix
  • Keeps the existing Dify configuration steps intact
  • Adds concise context for teams using trace data in evaluation workflows

Why

The Dify docs include separate Arize and Phoenix integration pages. This update makes the AX and Phoenix paths easier to distinguish before setup: AX for full-featured managed cloud or enterprise self-hosted deployments, and Phoenix for open-source local or self-hosted workflows.

Testing

  • Docs-only change; not run.

@arizedatngo
arizedatngo requested a review from RiskeyL as a code owner August 18, 2026 20:00
@dosubot dosubot Bot added size:S This PR changes 10-29 lines, ignoring generated files. documentation Improvements or additions to documentation labels Aug 18, 2026
@arizedatngo
arizedatngo force-pushed the arize-docs-positioning branch 3 times, most recently from f151b81 to 13f92ae Compare August 18, 2026 20:57
@dosubot dosubot Bot added size:M This PR changes 30-99 lines, ignoring generated files. and removed size:S This PR changes 10-29 lines, ignoring generated files. labels Aug 18, 2026
@arizedatngo
arizedatngo force-pushed the arize-docs-positioning branch from 13f92ae to 3a5aa85 Compare August 18, 2026 22:09
@dosubot dosubot Bot added size:S This PR changes 10-29 lines, ignoring generated files. and removed size:M This PR changes 30-99 lines, ignoring generated files. labels Aug 18, 2026
@arizedatngo
arizedatngo force-pushed the arize-docs-positioning branch from 3a5aa85 to e21b670 Compare August 19, 2026 20:17
guchenhe
guchenhe previously approved these changes Aug 20, 2026
@dosubot dosubot Bot added the lgtm This PR has been approved by a maintainer label Aug 20, 2026
- Unify the cloud and self-host copies; keep vendor positioning, guide links, and UTM parameters
- Add Phoenix Cloud alongside self-hosting in the Phoenix intros; scope local-development framing to the self-host tree (Dify exports traces server-side)
- Use root-relative internal links; drop the redundant info callouts
- Translate the updated sections across all eight zh/ja sibling pages
@dosubot dosubot Bot added size:L This PR changes 100-499 lines, ignoring generated files. and removed size:S This PR changes 10-29 lines, ignoring generated files. labels Aug 21, 2026
@RiskeyL

RiskeyL commented Aug 21, 2026

Copy link
Copy Markdown
Contributor

Thanks for the contribution @arizedatngo! We've pushed some edits on top of your branch. Mind taking a look before this merges?

What we changed:

  • Polished the wording to match our style guide and unified the cloud/self-host copies (they're parallel trees that stay in sync).
  • Added Phoenix Cloud to the Phoenix intros alongside self-hosting. It's the default endpoint in Dify's tracing config, and the only no-infrastructure option for Dify Cloud users.
  • Switched relative links to our root-relative convention and dropped the "For more details" callouts, which duplicated links now in the first paragraph.
  • Added the zh/ja translations. Every content change in this repo ships all three languages together.

One thing we noticed while reviewing: Dify exports traces from its backend workers, so a Phoenix instance on a developer's machine wouldn't receive traces from Dify Cloud. Only from a self-hosted Dify that can reach it. On that basis we kept the "local development" framing on the self-host pages and pointed Cloud users to Phoenix Cloud or a reachable self-hosted endpoint. Does that match how you see Phoenix used with Dify Cloud? Happy to adjust, and same goes for any of the product descriptions.

@arizedatngo

Copy link
Copy Markdown
Author

@RiskeyL thanks again for pushing edits on top of this branch. Since this is labeled lgtm, could you take one more look when you have a chance and let me know if anything else is needed before merge?

The main intent is to keep the existing Arize/Phoenix setup accurate while clarifying AX vs Phoenix positioning and using the canonical Arize evaluation resource links.

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

documentation Improvements or additions to documentation lgtm This PR has been approved by a maintainer size:L This PR changes 100-499 lines, ignoring generated files.

Projects

None yet

Development

Successfully merging this pull request may close these issues.

3 participants