Skip to content

design(dncl): 日本語モードの基本設計(記法・設定・冒頭の説明文・移り方) #1748

Closed

Description

@smalruby3-editor-bot

EPIC #1731 の基本設計。方針は develop にマージ済みの docs/dncl/policy.md(PR #1733)。決めることの一覧は #1732 のコメント(https://github.com/smalruby/smalruby3-editor/issues/1732#issuecomment-6840447448)。

決めること

  1. 記法ごとの採用: 一覧の表の各行を、方針の決め方(① 例題 → ② 例題に無いものは「言葉は DNCL・見た目は例題」→ ③ 揺れは新しい年度・DNCL → ④ DNCL か Ruby に近いもの → ⑤ 非公式の多数派か Ruby に近いもの)で決める。各行に「書くときの形」「読むときに受け付ける形」「根拠(資料 ID・DNCL の節)」を書く。
  2. 設定の項目とよくある設定のパターン: 設定にするのは、意味が変わるもの・問題文で約束されるもの(添字の始まり、コメントの記号、論理演算子の言葉など)。パターンの名前と中身。
  3. 冒頭の説明文: 形(コメントか専用の行か)、言い回し(公式の約束の型・常体・「,」)、設定の保存先(作品ごとか利用者ごとか)。
  4. 移り方: いまの「DNCL 風の形」と「標準の形」の扱い、既存の作品・教材・生成 AI の答え・docs への影響。
  5. 作る順番: 支える読み方(行番号と罫線を残して読めて動かせる → 行番号で行を指す → トレース → 実行回数 → 空欄・行の差し込み)を、どの順で sub-issue にするか。

進め方

  • AI が設計案(記法の表・設定・説明文の見本・移り方・順番)を作り、人間と 1 項目ずつ決める。
  • 決まったら、docs/dncl/ に設計の文書を置き(PR)、実装の sub-issue に分ける(infra は不要の見込み)。
  • テスト・教材には、センターの問題ではなく、記法をまねた自作のプログラムを使う。

Metadata

Metadata

Assignees

Labels

No labels
No labels

Type

No type

Projects

No projects

    Milestone

    No milestone

    Relationships

    None yet

    Development

    No branches or pull requests

    Issue actions