dotnet / dotnet/android-api-docs

Add XML documentation for smaller namespaces (Other)

Ouverte
#313 0 commentaires 0 réactions 0 personnes assignées Voir sur GitHub
Langage dominant
C#
Étoiles
3
Forks
12
Merge moyen
1 j 11 h
PR mergées (30 j)
57

Description

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.

Guide de contribution

Aucun guide de contribution indexé pour ce dépôt

Piste de recherche

Choisissez un namespace dans l’issue et exécutez la commande rg PowerShell fournie sur docs\xml, en excluant docs\xml\index.xml. Examinez les entrées To be added correspondantes et les résultats de l’importateur de références officielles ; le travail est considéré comme terminé lorsque les espaces réservés suivis sont résolus, avec l’avancement documenté à côté de PR #676.

Rédigé par le modèle d'indexation à partir du texte de l'issue.

Évaluation

Stack technique
powershell
Domaine
documentation
Type d'issue
Documentation
Difficulté
5/5
Temps estimé
Plus d'une semaine
Activité
À l'abandon
Clarté
Plutôt claire
Accessibilité débutants
25/100

Recevez les nouvelles issues par e-mail

Un résumé court des issues GitHub adaptées aux débutants.