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

Organize the examples directory and add an examples index

オープン
#656 コメント 0 件 リアクション 0 件 担当者 0 名 GitHub で見る

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

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

評価

難易度
4/5
見積もり時間
3〜5日
初心者へのやさしさ
64/100
issue の種類
ドキュメント
明瞭さ
明確に書かれている
活発さ
活発
技術スタック
wasm

調査の方向性

まず examples/ 配下の non-std ファイルを一覧化し、examples/std/README.md を読んでから、リポジトリの workflow、smoke runner、スクリプト、リンクを検索して、例への直接パスを確認します。tools/check_wave_corpus.py と関連する CI ジョブを使って、検出と WebAssembly のパスを検証します。カテゴリと examples/README.md が明確で、すべてのチェックに成功し、移動したパスへの古い参照が残っていなければ完了です。

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

説明

documentation good first issue

Why

The top-level examples/ directory currently mixes introductory language samples, larger application demos, platform-specific programs, WebAssembly CI fixtures, and standard-library examples.

Small files such as hello.wave and if.wave sit beside larger or target-specific programs such as doom.wave, tcp.wave, and the WebAssembly examples. examples/std/ already has its own focused layout and README, but the rest of the directory has no equivalent index or category structure.

Scope

  • Organize the non-std examples into a small set of clear categories such as basics/, language/, applications/, and platform/.
  • Keep examples/std/ as the standard-library example area rather than folding it into the new categories.
  • Add examples/README.md with a short description, run/check command, and any target or host requirements for each maintained example.
  • Update repository documentation, CI workflows, smoke runners, or scripts that reference moved example paths directly.
  • Preserve the intent and behavior of the existing examples; this issue is a layout/documentation cleanup, not a rewrite of their programs.

Completion criteria

  • A new contributor can tell which examples are introductory, language-focused, application-oriented, or target-specific from the directory layout and index.
  • Every moved .wave file is still discovered by tools/check_wave_corpus.py.
  • WebAssembly and other CI jobs use the new paths successfully.
  • examples/std/README.md remains valid and examples/std/ keeps its current role.
  • Repository links to example files are updated so no moved path is left stale.
主要言語
Rust
スター
56
フォーク
21
平均マージ
3時間 17分
マージ済み PR(30日)
61

環境構築

はじめの一歩

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

wavefnd/Wave のほかの issue

wavefnd/Wave の issue をすべて見る

似ている issue

Rust の issue をもっと見る

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

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