dotnet / dotnet/android-api-docs

Add XML documentation for smaller namespaces (Other)

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

描述

These **59 namespaces** are tracked here. Together they currently contain **618** `To be added` placeholders in source XML documentation. `docs\xml\index.xml` is excluded. | Namespace | Count | |---|---:| | `(global namespace)` | 1 | | `Android.Accessibilityservice.AccessibilityService` | 10 | | `Android.Accounts` | 9 | | `Android.AdServices.Exceptions` | 22 | | `Android.Annotation` | 21 | | `Android.App.AppSearch.Exceptions` | 16 | | `Android.App.AppSearch.Util` | 15 | | `Android.App.Jank` | 24 | | `Android.App.Roles` | 11 | | `Android.Crypto.Hpke` | 15 | | `Android.Graphics.Drawables.Shapes` | 20 | | `Android.Hardware.Location` | 19 | | `Android.Locations.Altitude` | 15 | | `Android.Media.Effect` | 16 | | `Android.Net.Wifi.Hotspot2` | 23 | | `Android.Net.Wifi.Hotspot2.Omadm` | 7 | | `Android.OS.Ext` | 18 | | `Android.Print.Pdf` | 3 | | `Android.PrintServices` | 17 | | `Android.Security.AdvancedProtection` | 21 | | `Android.Service.PersistentData` | 16 | | `Android.Service.Restrictions` | 5 | | `Android.Service.Textservice` | 5 | | `Android.Service.VR` | 14 | | `Android.Telephony.Cdma` | 11 | | `Android.Telephony.Ims.Stub` | 23 | | `Android.Telephony.Satellite` | 19 | | `Android.Test.Suitebuilder` | 11 | | `Android.Test.Suitebuilder.Annotation` | 31 | | `Android.Views.ContentCapture` | 5 | | `Dalvik.Annotation.Optimization` | 0 | | `Java.Beans` | 16 | | `Java.Interop.Expressions` | 17 | | `Java.Interop.Tools.JavaCallableWrappers` | 15 | | `Java.Nio.Charset.Spi` | 3 | | `Java.Nio.FileNio.Spi` | 22 | | `Java.Security.Acl` | 12 | | `Java.Util.Functions` | 16 | | `Java.Util.RandomGenerators` | 11 | | `Java.Util.Regex` | 12 | | `Javax.Crypto.Interfaces` | 2 | | `Javax.Net` | 5 | | `Javax.Security.Auth.Callback` | 6 | | `Javax.Security.Auth.Login` | 2 | | `Javax.Security.Auth.X500` | 15 | | `Javax.Xml` | 3 | | `Javax.Xml.Namespace` | 5 | | `Javax.Xml.Transform.Dom` | 11 | | `Javax.Xml.Transform.Sax` | 17 | | `Javax.Xml.Transform.Stream` | 10 | | `Javax.Xml.Xpath` | 24 | | `Org.Apache.Http.Auth.Params` | 14 | | `Org.Apache.Http.Client.Entity` | 8 | | `Org.Apache.Http.Conn.Util` | 11 | | `Org.Apache.Http.Cookie.Params` | 13 | | `Org.Xml.Sax.Ext` | 7 | | `Org.Xml.Sax.Helpers` | 15 | | `System.IO` | 5 | | `System.Linq` | 9 | Set a namespace and use this command to find its placeholders: ```powershell $namespace = 'Android.Accounts' rg -n -i --glob "$namespace/**" --glob "ns-$namespace.xml" 'to be added' docs\xml ``` For the global namespace entry: ```powershell rg -n -i --glob 'ns-.xml' 'to be added' docs\xml ``` ## Update log - 2026-09-10: Refreshed the placeholder scan from **724** to **749** (increased by **25**). Related documentation PRs: [#333](https://github.com/dotnet/android-api-docs/pull/333), [#350](https://github.com/dotnet/android-api-docs/pull/350), [#360](https://github.com/dotnet/android-api-docs/pull/360), [#644](https://github.com/dotnet/android-api-docs/pull/644).
- 2026-09-10: Completed official-reference importer dry-run/review/apply passes for all 59 tracked namespaces. Imported **73** exact matches in [five commits](https://github.com/dotnet/android-api-docs/compare/b8e1b0466...a975d2125); **618** placeholders remain where the importer reported no safe exact source mapping (1,128 blocker records).

- 2026-09-10: Opened progress PR [#676](https://github.com/dotnet/android-api-docs/pull/676) for the 73 exact official-source imports. The issue remains open pending resolution of the 618 conservatively blocked placeholders.

贡献指南

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

调研方向

Choose a namespace from the issue and run the provided PowerShell rg command against docs\xml, excluding docs\xml\index.xml. Review the matching To be added entries and the official-reference importer results; done means resolving the tracked placeholders, with progress documented alongside PR #676.

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

评估

技术栈
powershell
领域
documentation
Issue 类型
文档
难度
5/5
预计耗时
一周以上
活跃度
停滞
描述清晰度
基本清楚
新手友好度
25/100

把新 issue 发到你的邮箱

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