Skip to content

Commit ea1211d

Browse files
Rename croktile -> croqtile, rewrite Ch5-Ch9 with PL/compiler framing
- Global rename: croktile -> croqtile across all files, filenames, configs - Ch5: reframe around PL control flow (predication vs structured concurrency) - Ch5 figure: top-bottom layout instead of left-right - Ch6: restructure as practice chapter (swap + event pipeline kernels) - Ch7: bridge from Ch2, add TMA hardware depth, 5 new figures - Ch8: add __device__ functions, inline ASM (moe_topk), compilation flow figure - Ch9: fix choreo_assert -> assert, add -v/-rtc, remove -O0 - All ZH translations updated Made-with: Cursor
1 parent 8cff448 commit ea1211d

76 files changed

Lines changed: 1623 additions & 842 deletions

File tree

Some content is hidden

Large Commits have some content hidden by default. Use the searchbox below for content that may be hidden.

‎.cursor/rules/documentation-architecture.mdc‎

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -16,7 +16,7 @@ Source: Divio Documentation System (diataxis.fr)
1616
| **Reference** | Information | Encyclopedia | "X is defined as…" |
1717
| **Explanation** | Understanding | Essay / article | "The reason X works this way is…" |
1818

19-
## How This Maps to croktile-tutorial
19+
## How This Maps to croqtile-tutorial
2020

2121
| Directory | Type | Write It As |
2222
|-----------|------|-------------|

‎.cursor/rules/gpu-documentation-patterns.mdc‎

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -6,7 +6,7 @@ alwaysApply: false
66

77
# GPU Documentation Patterns
88

9-
Sources: NVIDIA CUDA Programming Guide, AMD Composable Kernel docs, croktile-tutorial best practices
9+
Sources: NVIDIA CUDA Programming Guide, AMD Composable Kernel docs, croqtile-tutorial best practices
1010

1111
## Progressive Complexity
1212

.cursor/skills/croktile-chapter-rewrite/SKILL.md renamed to .cursor/skills/croqtile-chapter-rewrite/SKILL.md

Lines changed: 8 additions & 8 deletions
Original file line numberDiff line numberDiff line change
@@ -1,16 +1,16 @@
11
---
2-
name: croktile-chapter-rewrite
2+
name: croqtile-chapter-rewrite
33
description: >-
4-
Rewrites Croktile tutorial chapters (ch01–ch09) to match the storytelling,
4+
Rewrites Croqtile tutorial chapters (ch01–ch09) to match the storytelling,
55
figure, and structure standards established in ch02 and ch03. Use when
66
rewriting, reviewing, or restructuring any tutorial chapter, or when the
77
user mentions chapter quality, chapter structure, or tutorial consistency.
88
---
99

10-
# Croktile Tutorial Chapter Rewrite Standard
10+
# Croqtile Tutorial Chapter Rewrite Standard
1111

1212
This skill encodes the writing and structural conventions that emerged from
13-
human-reviewed iterations of Chapters 2 and 3 of the Croktile tutorial.
13+
human-reviewed iterations of Chapters 2 and 3 of the Croqtile tutorial.
1414
Apply these rules when rewriting or reviewing any tutorial chapter.
1515

1616
## 1. Opening Pattern (Mandatory)
@@ -34,22 +34,22 @@ The bridge is a single narrative sentence or short paragraph — not a bullet li
3434

3535
### Beat 2 — Concept Introduction (Storytelling)
3636

37-
Before showing any Croktile syntax, explain the **concept itself** using
37+
Before showing any Croqtile syntax, explain the **concept itself** using
3838
general knowledge the reader can relate to:
3939

4040
- What is this concept/model/mindset in the real world or in GPU hardware?
4141
- How do traditional tools (CUDA, OpenCL) handle it, and what makes it hard?
42-
- What is Croktile's key insight or design choice for this concept?
42+
- What is Croqtile's key insight or design choice for this concept?
4343

4444
This section reads like a mini-essay — conversational, specific, opinionated.
4545
Avoid bullet-point walls. Use analogies, contrasts, and concrete numbers.
4646

4747
> **Pattern** (ch02): "A GPU does not fetch one 32-bit integer from memory at a
4848
> time. It fetches contiguous blocks — 128 bytes, 256 bytes — in a single
49-
> transaction… Croktile is designed around this insight."
49+
> transaction… Croqtile is designed around this insight."
5050
5151
> **Pattern** (ch03): "Parallelism is a virtual concept… CUDA conflates logical
52-
> structure and physical mapping… Croktile untangles them."
52+
> structure and physical mapping… Croqtile untangles them."
5353
5454
## 2. Single Storyline per Chapter
5555

‎README.md‎

Lines changed: 5 additions & 5 deletions
Original file line numberDiff line numberDiff line change
@@ -1,21 +1,21 @@
1-
# Croktile
1+
# Croqtile
22

3-
Documentation and tutorials for **Croktile**, a C++ embedded DSL for high-performance kernel programming, featuring easy-to-use syntax with zero-cost abstractions, comprehensive compile-time safety checks, first-class dynamic shapes and symbolic dimensions, and an AI-tuning-friendly design from the ground up.
3+
Documentation and tutorials for **Croqtile**, a C++ embedded DSL for high-performance kernel programming, featuring easy-to-use syntax with zero-cost abstractions, comprehensive compile-time safety checks, first-class dynamic shapes and symbolic dimensions, and an AI-tuning-friendly design from the ground up.
44

55
## Documentation Structure
66

77
### Part I — [Tutorial](tutorial/index.md)
88

9-
A step-by-step walkthrough for newcomers. Starts with the simplest possible kernel and progressively introduces Croktile syntax through increasingly sophisticated matmul variants. No prior Croktile experience required — just basic C++ and GPU programming concepts.
9+
A step-by-step walkthrough for newcomers. Starts with the simplest possible kernel and progressively introduces Croqtile syntax through increasingly sophisticated matmul variants. No prior Croqtile experience required — just basic C++ and GPU programming concepts.
1010

1111
### Part II — [Performance Tuning Demos](optimization/index.md)
1212

1313
Case-oriented performance engineering. Each section profiles a real kernel family, identifies bottlenecks, and applies optimization patterns to push toward hardware peak. Covers profiling, benchmarking, compiler flags, and AI-tuning workflows.
1414

1515
### Part III — [Coding Reference](documentation/index.md)
1616

17-
Exhaustive syntax and semantics reference. Every Croktile construct — shapes, DMA, loops, parallelism, events, memory, macros, and more — is documented in detail.
17+
Exhaustive syntax and semantics reference. Every Croqtile construct — shapes, DMA, loops, parallelism, events, memory, macros, and more — is documented in detail.
1818

1919
### Part IV — [Design Rationales](advanced/index.md)
2020

21-
Deep-dive articles on Croktile's design rationale, tradeoffs, and frontier challenges. *(Planned)*
21+
Deep-dive articles on Croqtile's design rationale, tradeoffs, and frontier challenges. *(Planned)*

‎advanced/index.md‎

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -2,7 +2,7 @@
22

33
*This section is planned for future content.*
44

5-
Deep-dive articles on Croktile's design rationale, tradeoffs, and frontier challenges — similar in spirit to the MLIR rationale documents.
5+
Deep-dive articles on Croqtile's design rationale, tradeoffs, and frontier challenges — similar in spirit to the MLIR rationale documents.
66

77
## Planned Topics
88

73.3 KB
Loading
74.5 KB
Loading
64.3 KB
Loading
65 KB
Loading
54.4 KB
Loading

0 commit comments

Comments
 (0)