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

[Lane 2 · kotlin-core] NotImplemented stubs — Markdown output for the operator docs generator

Aperta Adatta ai principianti
  • Qualcosa non va?
#1,418 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à
2/5
Tempo stimato
1-3 ore
Idoneità per principianti
82/100
Tipo di issue
Funzionalità
Chiarezza
Specificata chiaramente
Stato di attività
Attiva
Stack tecnologico
kotlin
Ambito
documentation

Direzione di ricerca

Inizia da build-logic/convention/src/main/kotlin/GenerateDocumentationTask.kt e leggi generateAsciidoc per comprendere l’indice, le pagine degli operatori e la matrice di copertura. Implementa il corrispondente output Markdown, poi riduci da 2 a 1 il conteggio in config/stub-allowlist.txt ed esegui ./gradlew checkUnmarkedStubs. Il lavoro è terminato quando Markdown mostra le stesse righe della matrice AsciiDoc e il risultato viene riportato nella issue principale #1414.

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

Descrizione

coding good first issue size:s skill:kotlin-core sub-issue

Sub-issue of #1414 ([Feature]: Close the remaining NotImplemented stubs outside the operator surface).

Lane: 2 · Kotlin core
Skill needed: Kotlin (Gradle build-logic). No SKaiNET runtime knowledge needed.
Size: s (a few hours)
Blocked by: nothing

What to do

  1. GenerateDocumentationTask (build-logic/convention/src/main/kotlin/GenerateDocumentationTask.kt) throws for DocumentationFormat.MARKDOWN (and HTML).
  2. Implement Markdown by mirroring generateAsciidoc (index, one page per operator, coverage matrix as a Markdown table).
  3. Lower the file's count in config/stub-allowlist.txt from 2 to 1 (HTML stays); run ./gradlew checkUnmarkedStubs and try it with documentation { format.set(DocumentationFormat.MARKDOWN) } locally.

Acceptance

  • Markdown output renders the same rows as the AsciiDoc matrix
  • Result reported back on the parent issue

Notes

If something here turns out to be wrong or much bigger than the size label, comment on this issue or open a specific bug instead of blocking the parent.

Coverage matrix: docs/modules/ROOT/pages/reference/ops-status-matrix.adoc · How lanes work: Issue taxonomy

Lingua principale
Kotlin
Stelle
52
Fork
15
Merge medio
1g 10h
PR unite (30g)
59

Preparare l'ambiente

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 SKaiNET-developers/SKaiNET

Tutte le issue di SKaiNET-developers/SKaiNET

Issue simili

Altre issue su Kotlin

Ricevi le nuove issue nella tua casella

Un breve riepilogo di issue GitHub adatte ai principianti.