Skip to content

Comments

Restructure public/docs/ into per-language directory hierarchy#166

Draft
Copilot wants to merge 4 commits intomainfrom
copilot/create-language-directories
Draft

Restructure public/docs/ into per-language directory hierarchy#166
Copilot wants to merge 4 commits intomainfrom
copilot/create-language-directories

Conversation

Copy link
Contributor

Copilot AI commented Feb 22, 2026

Flat public/docs/{lang}-{n}.md files are reorganized into a structured directory tree with per-language index.yml metadata and per-page section splits.

New structure

public/docs/
└── cpp/
    ├── index.yml
    ├── 0-intro/
    │   ├── -intro.md          # intro text (no frontmatter)
    │   ├── 0.md               # ## C++とは?
    │   ├── 1.md               # ### 特徴
    │   └── 9-include-iostream.md
    ├── 1-types-control/
    │   └── ...
    └── ...

index.yml per language

name: C++
description: C++の基本から高度な機能までを学べるチュートリアル
pages:
  - slug: 0-intro
    name: C++の世界へようこそ
    title: C++の世界へようこそ
  - slug: 1-types-control
    name: 型システムと制御構造
    title: C++の型システムと制御構造:静的型付けとスコープを再確認する

Section files

Each h2/h3 heading becomes its own .md file with YAML frontmatter. The -intro.md file holds the text before the first section heading and has no frontmatter.

---
id: cpp-intro-0    # unique across all langs/pages/sections; index-inclusive
title: C++とは?
level: 2
---

## C++とは?
...

Scope

  • 6 languages: cpp (13 pages), python (9), ruby (12), javascript (10), typescript (8), rust (12)
  • 64 page directories, 64 -intro.md files, 734 section files
  • All IDs unique; all YAML frontmatter valid
  • No changes to app/; original {lang}-{n}.md flat files retained alongside

✨ Let Copilot coding agent set things up for you — coding agent works faster and does higher quality work when set up for your repo.

…x.yml

Co-authored-by: na-trium-144 <100704180+na-trium-144@users.noreply.github.com>
@cloudflare-workers-and-pages
Copy link

cloudflare-workers-and-pages bot commented Feb 22, 2026

Deploying with  Cloudflare Workers  Cloudflare Workers

The latest updates on your project. Learn more about integrating Git with Workers.

Status Name Latest Commit Preview URL Updated (UTC)
✅ Deployment successful!
View logs
my-code c987147 Commit Preview URL

Branch Preview URL
Feb 22 2026, 04:06 PM

Copilot AI changed the title [WIP] Add directory structure for language documentation Restructure public/docs/ into per-language directory hierarchy Feb 22, 2026
Copilot AI requested a review from na-trium-144 February 22, 2026 12:15
@na-trium-144 na-trium-144 linked an issue Feb 22, 2026 that may be closed by this pull request
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

ドキュメントをセクションごとに分割

2 participants