dotnet / dotnet/android-api-docs

Add XML documentation for Java.Interop

Đang mở
#193 0 bình luận 0 reaction 0 người được giao Xem trên GitHub
Ngôn ngữ chính
C#
Star
3
Fork
12
Merge trung bình
1 ngày 11 giờ
Pull request đã merge (30 ngày)
57

Mô tả

The `Java.Interop` namespace originally contained **2,817** exact `To be added` placeholders in source XML documentation (excluding `docs\xml\index.xml`).

PR #660 imported **20** entries backed by exact official Java 21 Javadoc and merged in `eb93ede4aa3190e7e9207431c9b178507272ffcc`.

## Remaining work

**2,797 placeholders remain:**

| Count | Category |
|---:|---|
| 2,327 | Managed/JNI support types with no exact Android/Java type registration or official managed API source |
| 380 | Array-rank JNI signatures with no declared Java API detail page |
| 87 | Exact Java type exists, but the member is managed lifecycle/wrapper/state behavior without an exact Java registration |
| 2 | Exact source member exists, but no official parameter channel matches the managed receiver/renamed argument |
| 1 | Managed namespace with no declared Android/Java API page |

The broad Oracle JNI specification import attempted during #660 was removed after review because native tables, parameters, return conventions, and calling protocols do not exactly describe the managed wrappers. The remaining work therefore needs Java.Interop-specific managed documentation rather than copied JNI/Javadoc prose, unless new exact metadata mappings become available.

```powershell
rg -n -i --glob 'Java.Interop/**' --glob 'ns-Java.Interop.xml' 'to be added' docs\xml
```

See #660 for the importer changes, validation, and review history.

Hướng dẫn đóng góp

Chưa lập chỉ mục được hướng dẫn đóng góp cho kho mã nguồn này

Hướng nghiên cứu

Bắt đầu bằng cách chạy tìm kiếm rg đã được ghi lại trong docs\xml cho `Java.Interop` và `To be added`, sau đó đọc #660 về importer, validation và lịch sử review. Công việc được xem là hoàn tất khi các placeholder còn lại được thay thế bằng tài liệu Managed dành riêng cho Java.Interop hoặc các ánh xạ metadata chính xác mới được hỗ trợ, đồng thời giữ nguyên các loại trừ đã nêu và các yêu cầu validation.

Do mô hình lập chỉ mục viết ra từ nội dung của issue.

Đánh giá

Công nghệ
csharp, java
Lĩnh vực
documentation
Loại issue
Tài liệu
Độ khó
5/5
Thời gian dự kiến
Hơn một tuần
Mức độ hoạt động
Ít trao đổi
Độ rõ ràng
Cần làm rõ
Mức phù hợp với người mới
30/100

Nhận issue mới trong hộp thư của bạn

Bản tóm tắt ngắn những issue GitHub phù hợp với người mới.