Conversation
There was a problem hiding this comment.
Pull request overview
C++ 向けドキュメントの「はじめに（preface）」と第1章（環境構築）を整備し、VitePress のサイドバーに /cpp/ セクションを追加してナビゲーション可能にする PR です。
Changes:
docs/cpp/preface/に導入文・ガイダンス・テキスト説明を追加/刷新docs/cpp/chapter-1/に Mac / Windows の環境構築手順を追加/刷新docs/.vitepress/config.tsの sidebar を/cpp/と/text/のマルチセクション構成に変更
Reviewed changes
Copilot reviewed 6 out of 6 changed files in this pull request and generated 6 comments.
Show a summary per file
| File | Description |
|---|---|
| docs/cpp/preface/index.md | C++ テキストの導入ページを追加 |
| docs/cpp/preface/1.md | 講習会ガイダンス本文を追加 |
| docs/cpp/preface/2.md | テキスト説明・運営情報・謝辞等を追加 |
| docs/cpp/chapter-1/1-A.md | Mac 環境構築手順を追加 |
| docs/cpp/chapter-1/1-B.md | Windows（WSL/VSCode）環境構築手順を追加 |
| docs/.vitepress/config.ts | /cpp/ 用サイドバーを追加し、sidebar をオブジェクト形式へ変更 |
💡 Add Copilot custom instructions for smarter, more guided reviews. Learn how to get started.
|
|
||
| これは「プログラミング基礎講習」のテキストです。これから全9章に渡ってプログラミングの基礎を学ぶ講習会になっています。 | ||
|
|
||
| :::info traP外の方へ |
There was a problem hiding this comment.
:::info traP外の方へ の「traP外」は他ページでは「traP 外」と空白を入れているため、可読性/表記ゆれ防止のためスペースを入れて統一した方がよいです。
| :::info traP外の方へ | |
| :::info traP 外の方へ |
|
|
||
| 次に 2 つめ、各班で個別にプログラミングの講習会を開くのはあまりに非効率ということ。ほぼ同じ内容の講習会を 5 つも立てることになってしまいます……。 | ||
|
|
||
| 3 つめ、一つの言語を会得してしまえば、他の言語も用意に習得できること。特に、本講習で扱う「C++」言語は、今主流の様々な言語の元になっている言語といっても過言ではなく、他の言語を学ぶと意外と似てると何度も感じることになります。 |
There was a problem hiding this comment.
「他の言語も用意に習得できること」は誤字に見えます（文脈的に「容易に」）。誤った単語だと意味が変わるので修正してください。
| 3 つめ、一つの言語を会得してしまえば、他の言語も用意に習得できること。特に、本講習で扱う「C++」言語は、今主流の様々な言語の元になっている言語といっても過言ではなく、他の言語を学ぶと意外と似てると何度も感じることになります。 | |
| 3 つめ、一つの言語を会得してしまえば、他の言語も容易に習得できること。特に、本講習で扱う「C++」言語は、今主流の様々な言語の元になっている言語といっても過言ではなく、他の言語を学ぶと意外と似てると何度も感じることになります。 |
| 3. パスワードを求められるので、WSLで設定したパスワードを入力 | ||
| 4. WSL上で `sudo apt install clang zip curl -y` を実行する | ||
| 5. `clang --version` で clang のバージョンが表示されれば成功 | ||
| 6. 11. traQ の tasks チャンネルで :cpp: を押す |
There was a problem hiding this comment.
Step 2 の最後が 6. 11. traQ... となっており、本文中に余計な 11. が残っていて手順として紛らわしいです（6. traQ... のようにするなど、番号表記を整理してください）。
| 6. 11. traQ の tasks チャンネルで :cpp: を押す | |
| 6. traQ の tasks チャンネルで :cpp: を押す |
|
|
||
| 1. VSCodeの 画面で `Ctrl` + `Shift` + `X` | ||
|
|
||
| 2. 「C++」と入力し、「C/C++ Extenstion Pack」の拡張機能を追加 |
There was a problem hiding this comment.
VSCode 拡張機能名が Extenstion になっていますが、正しくは Extension です。検索でヒットしづらくなるので表記を修正してください（例: "C/C++ Extension Pack"）。
| 2. 「C++」と入力し、「C/C++ Extenstion Pack」の拡張機能を追加 | |
| 2. 「C++」と入力し、「C/C++ Extension Pack」の拡張機能を追加 |
|
|
||
| 1. VSCodeの 画面で `⌘` + `Shift` + `X` | ||
|
|
||
| 2. 「C++」と入力し、「C/C++ Extenstion」の拡張機能を追加 |
There was a problem hiding this comment.
VSCode 拡張機能名が Extenstion になっていますが、正しくは Extension です。検索でヒットしづらくなるので表記を修正してください。
| 2. 「C++」と入力し、「C/C++ Extenstion」の拡張機能を追加 | |
| 2. 「C++」と入力し、「C/C++ Extension」の拡張機能を追加 |
| text: 'はじめに', | ||
| link: '/cpp/preface/', | ||
| items: [ | ||
| { text: 'この講習会について', link: '/cpp/preface/1' }, |
There was a problem hiding this comment.
/cpp/preface/1 のページタイトルは「講習会ガイダンス」ですが、サイドバー表示が「この講習会について」のままになっています。ナビ上の表記とページ内容がずれるので、サイドバーの text をページタイトルに合わせるなどして整合性を取ってください。
| { text: 'この講習会について', link: '/cpp/preface/1' }, | |
| { text: '講習会ガイダンス', link: '/cpp/preface/1' }, |
No description provided.