dotnet / dotnet/android-api-docs

Add XML documentation for smaller namespaces (Other)

Đang mở
#313 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ả

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.

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

Chọn một namespace từ issue và chạy lệnh rg PowerShell được cung cấp trên docs\xml, loại trừ docs\xml\index.xml. Xem lại các mục To be added khớp và kết quả của trình nhập official-reference; hoàn tất nghĩa là giải quyết các placeholder được theo dõi, với tiến độ được ghi lại cùng PR #676.

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

Đánh giá

Công nghệ
powershell
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
Đình trệ
Độ rõ ràng
Khá rõ ràng
Mức phù hợp với người mới
25/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.