dotnet / dotnet/android-api-docs

Add XML documentation for smaller namespaces (Other)

Abierto
#313 0 comentarios 0 reacciones 0 asignados Ver en GitHub
Lenguaje dominante
C#
Estrellas
3
Forks
12
Merge medio
21 h 11 min
PR fusionados (30 d)
96

Descripción

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.

Guía de contribución

No hay ninguna guía de contribución indexada para este repositorio

Línea de trabajo

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.

Escrito por el modelo de indexación a partir del texto del issue.

Evaluación

Stack tecnológico
powershell
Área
documentation
Tipo de issue
Documentación
Dificultad
5/5
Tiempo estimado
Más de una semana
Estado de actividad
Estancado
Claridad
Bastante claro
Aptitud para principiantes
25/100

Recibe los nuevos issues en tu correo

Un resumen breve de issues de GitHub para principiantes.