Hacktoberfest 2026: le issue che i maintainer hanno segnato per ottobre, aperte e adatte ai principianti. Sfoglia le issue Hacktoberfest

Add XML documentation for Java.Interop

Aperta
  • Qualcosa non va?
#193 0 commenti 0 reazioni 0 assegnatari Vedi su GitHub

I maintainer di solito rispondono entro 1 giorno

Nessuno ha ancora preso questa issue.

Valutazione

Difficoltà
5/5
Tempo stimato
Più di una settimana
Idoneità per principianti
30/100
Tipo di issue
Documentazione
Chiarezza
Da chiarire
Stato di attività
Tranquilla
Stack tecnologico
csharp, java
Ambito
documentation

Direzione di ricerca

Inizia eseguendo la ricerca rg documentata in docs\xml per Java.Interop e To be added, quindi leggi #660 sull’importer, sulla convalida e sulla cronologia delle review. Il lavoro è completato quando i segnaposto rimanenti sono stati sostituiti con documentazione Managed specifica di Java.Interop o con nuove mappature esatte dei metadati supportate, preservando le esclusioni indicate e le aspettative di convalida.

Scritto dal modello di indicizzazione a partire dal testo della issue.

Descrizione

The Java.Interop namespace originally contained 2,817 exact To be added placeholders in source XML documentation (excluding docs\xml\index.xml).

PR #660 imported 20 entries backed by exact official Java 21 Javadoc and merged in eb93ede4aa3190e7e9207431c9b178507272ffcc.

Remaining work

2,797 placeholders remain:

Count Category
2,327 Managed/JNI support types with no exact Android/Java type registration or official managed API source
380 Array-rank JNI signatures with no declared Java API detail page
87 Exact Java type exists, but the member is managed lifecycle/wrapper/state behavior without an exact Java registration
2 Exact source member exists, but no official parameter channel matches the managed receiver/renamed argument
1 Managed namespace with no declared Android/Java API page

The broad Oracle JNI specification import attempted during #660 was removed after review because native tables, parameters, return conventions, and calling protocols do not exactly describe the managed wrappers. The remaining work therefore needs Java.Interop-specific managed documentation rather than copied JNI/Javadoc prose, unless new exact metadata mappings become available.

rg -n -i --glob 'Java.Interop/**' --glob 'ns-Java.Interop.xml' 'to be added' docs\xml

See #660 for the importer changes, validation, and review history.

Lingua principale
C#
Stelle
3
Fork
12
Merge medio
6h 26m
PR unite (30g)
82

Preparare l'ambiente

Questo progetto non fornisce container di sviluppo, Dockerfile né guida per i contributori, quindi l'ambiente è a tuo carico: parti dal suo README e consulta la nostra guida al primo contributo per i passaggi generali.

Come iniziare

  1. Leggi tutta la issue e poi la guida ai contributi del progetto.
  2. Commenta sulla issue per dire che te ne occupi tu — evita che due persone facciano lo stesso lavoro.
  3. Fai un fork del repository e lavora su un branch.
  4. Apri una pull request che faccia riferimento al numero della issue.

Altre issue di dotnet/android-api-docs

Tutte le issue di dotnet/android-api-docs

Issue simili

Altre issue su C#

Ricevi le nuove issue nella tua casella

Un breve riepilogo di issue GitHub adatte ai principianti.