Hacktoberfest 2026:メンテナが10月に向けて印を付けた、オープンで初心者向けの issue。 Hacktoberfest の issue を見る

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

オープン 初心者向け
#1,418 コメント 0 件 リアクション 0 件 担当者 0 名 GitHub で見る

メンテナーはふだん 1 日以内に返信

まだ誰も着手していません。

評価

難易度
2/5
見積もり時間
1〜3時間
初心者へのやさしさ
82/100
issue の種類
機能追加
明瞭さ
明確に書かれている
活発さ
活発
技術スタック
kotlin
領域
documentation

調査の方向性

build-logic/convention/src/main/kotlin/GenerateDocumentationTask.ktから始め、インデックス、演算子ページ、カバレッジマトリックスを理解するためにgenerateAsciidocを読んでください。対応するMarkdown出力を実装し、config/stub-allowlist.txtの数を2から1に減らしてから、./gradlew checkUnmarkedStubsを実行してください。MarkdownがAsciiDocマトリックスと同じ行を出力し、その結果が親issue #1414で報告されたら完了です。

索引モデルが issue の本文から書いたものです。

説明

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

主要言語
Kotlin
スター
52
フォーク
15
平均マージ
1日 10時間
マージ済み PR(30日)
59

環境構築

はじめの一歩

  1. issue を最後まで読み、次にプロジェクトのコントリビューションガイドを読みます。
  2. 着手することを issue にコメントします — 二人が同じ作業をするのを防げます。
  3. リポジトリをフォークし、ブランチを切って変更します。
  4. issue 番号を参照したプルリクエストを送ります。

SKaiNET-developers/SKaiNET のほかの issue

SKaiNET-developers/SKaiNET の issue をすべて見る

似ている issue

Kotlin の issue をもっと見る

新しい issue をメールで受け取る

初心者向けの GitHub issue を短くまとめたダイジェスト。