dotnet / dotnet/android-api-docs

Add XML documentation for smaller namespaces (Other)

Offen
#313 0 Kommentare 0 Reaktionen 0 zugewiesene Personen Auf GitHub ansehen
Vorherrschende Sprache
C#
Sterne
3
Forks
12
Ø Merge
1 T. 11 Std.
Gemergte PRs (30 T.)
57

Beschreibung

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.

Beitragsleitfaden

Für dieses Repository ist kein Beitragsleitfaden indexiert

Rechercherichtung

Wählen Sie einen Namespace aus dem Issue und führen Sie den bereitgestellten PowerShell-rg-Befehl gegen docs\xml aus, wobei docs\xml\index.xml ausgeschlossen wird. Prüfen Sie die übereinstimmenden To be added-Einträge und die Ergebnisse des Official-Reference-Importers; abgeschlossen bedeutet, die nachverfolgten Platzhalter aufzulösen, wobei der Fortschritt neben PR #676 dokumentiert wird.

Vom Indexierungsmodell aus dem Issue-Text verfasst.

Bewertung

Tech-Stack
powershell
Bereich
documentation
Issue-Typ
Dokumentation
Schwierigkeit
5/5
Geschätzter Aufwand
Über eine Woche
Aktivitätsstatus
Veraltet
Klarheit
Größtenteils klar
Anfängerfreundlichkeit
25/100

Neue Issues direkt in Ihr Postfach

Eine kurze Übersicht über anfängerfreundliche GitHub-Issues.