NeverENG opened a new pull request, #34: URL: https://github.com/apache/dubbo-net/pull/34
Refs #32; follows the documentation track of #16. Supersedes the unmerged, closed documentation-only PR #33 by including its import-note removal in one coherent change. ## Why The two READMEs mix usage, protocol limits, troubleshooting, and test instructions. A contributor needs a short route through the actual call path without a second, easily stale implementation manual. Design decisions and Git history also need different homes. ## What changed - Add paired `Docs/en/index.md` / `Docs/zh/index.md` code maps: public call and signature inference → Provider discovery and metadata handoff → service driver, selection/reservation, Native/Triple dispatch and release. Every step links to the current source and relevant tests. The maps distinguish normal calls from provider-change callbacks and link back to the user guides, existing protocol notes, and end-to-end environment guide. - Link both READMEs to the two maps and the changelog; do not relocate or remove current usage and compatibility guidance. - Add a bilingual RFC convention and minimum template in `Docs/RFC.md`. No fictional decision or empty RFC directory is created. - Add `CHANGELOG.md` as an index of verified merged PRs and the import merge/compare view; label the section **Unreleased**, not an unverified package release. - Remove the old `Docs/ImportReviewStatus.md` working notes; import provenance remains in PR #1 and Git history. This removal does **not** assert that legal/SGA/IP-clearance matters are completed. `LICENSE` and `NOTICE` are unchanged. ## Document ownership / scope | Existing material | Decision | | --- | --- | | English/Chinese READMEs | Keep as user guides and language entry points; link to the code maps. | | Native Dubbo / Triple protocol notes | Keep at their existing paths; code maps link rather than copy them. | | End-to-end environment / Java fixture guides | Keep as test-operation guides; code maps link to them. | | Import working notes | Remove from the active documentation tree; PR #1/Git history remain the record. | This PR is docs-only: no runtime, test, namespace, or resource-ownership refactor. Further reduction of the long READMEs remains a separately scoped follow-up under #32; do not remove needed user guidance before an alternative exists. ## Validation - Inspected the linked call sites and tests in the current `main` snapshot. - Checked all 12 remaining Markdown files for missing relative link targets: none; compared the two code maps' 33 targets each: identical except the reciprocal language link. - Verified the cited merged PRs and import commit via GitHub, and the import-to-`main` compare view via the GitHub API. - `git diff --check` passed. No runtime tests run because the changes are documentation-only. -- This is an automated message from the Apache Git Service. To respond to the message, please log on to GitHub and use the URL above to go to the specific comment. To unsubscribe, e-mail: [email protected] For queries about this service, please contact Infrastructure at: [email protected] --------------------------------------------------------------------- To unsubscribe, e-mail: [email protected] For additional commands, e-mail: [email protected]
