dotnet / dotnet/android-api-docs

Add XML documentation for Java.Interop

未关闭
#193 0 条评论 0 个 reaction 已指派 0 人 在 GitHub 查看
主要语言
C#
星标
3
派生
12
平均合并
1 天 11 小时
30 天内合并 PR
57

描述

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.

贡献指南

这个仓库没有索引到贡献指南

调研方向

首先,在 docs\xml 中对 `Java.Interop` 和 `To be added` 运行文档中说明的 rg 搜索,然后阅读 #660,了解 importer、validation 和 review 历史。完成的标准是:将剩余的占位符替换为 Java.Interop 专用的 Managed 文档,或替换为新支持的精确 metadata 映射,同时保留所述的排除项和 validation 预期。

由索引模型根据 Issue 内容生成。

评估

技术栈
csharp, java
领域
documentation
Issue 类型
文档
难度
5/5
预计耗时
一周以上
活跃度
冷清
描述清晰度
需要澄清
新手友好度
30/100

把新 issue 发到你的邮箱

精选适合新手参与的 GitHub issue 摘要。