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]

Reply via email to