Description

What changed

Top-level integration documentation

The root README.md was reworked to align around the LoongSuite-recommended integration path (loongsuite-distro + loongsuite-bootstrap + loongsuite-instrument), with clearer Option A/B/C guidance and source-install instructions. The source-install section now emphasizes installing core and local editable packages in a single pip install command to avoid resolver-induced version replacement in split installs, and OTLP exporter prerequisites were clarified.

Chinese documentation and language switch

A full Chinese translation was added as README-zh.md, and both top-level READMEs now include a centered language switch block at the top for quick navigation between English and Simplified Chinese.

Instrumentation package integration flow refresh

Multiple instrumentation-loongsuite/*/README.md guides were updated to remove outdated source/bootstrap patterns and align with root recommendations:

• Packages with PyPI release path now document Option C (pip install loongsuite-instrumentation-*).
• Packages not yet on PyPI (agno, dify, mcp) now document Option A (loongsuite-bootstrap -a install --latest).
• Runtime examples consistently prefer loongsuite-instrument.

LoongSuite component docs/changelog alignment

loongsuite-distro README content was migrated from RST to Markdown, pyproject.toml readme metadata was updated to README.md, and the old RST file now redirects readers. loongsuite-site-bootstrap/README.md was updated to clarify its role and how it works together with loongsuite-bootstrap. Top-level and per-package changelogs were updated to reflect this docs pass.

util-genai standalone compatibility fix

util/opentelemetry-util-genai/src/opentelemetry/util/genai/utils.py added bypass logic to avoid hard dependency on instrumentation initialization flow, so opentelemetry-util-genai can operate as a standalone SDK in non-instrumentation setups. The fix is documented in util/opentelemetry-util-genai/CHANGELOG-loongsuite.md.

Documentation

• Top-level docs: README.md, README-zh.md updated for integration guidance and bilingual navigation.
• Instrumentation docs: multiple instrumentation-loongsuite/*/README.md files updated to recommended Option A/C onboarding.

Type of change

Please delete options that are not relevant.

• Bug fix (non-breaking change which fixes an issue)
• Breaking change (fix or feature that would cause existing functionality to not work as expected)
• This change requires a documentation update

Does This PR Require a Core Repo Change?

• No.

Checklist:

See contributing.md for styleguide, changelog guidelines, and more.

• Followed the style guidelines of this project
• Changelogs have been updated
• Documentation has been updated