From e13a25f8ff8c680740291b6050654768845ebd98 Mon Sep 17 00:00:00 2001
From: Burak Varli <unexge@gmail.com>
Date: Wed, 21 Jan 2026 19:50:01 +0000
Subject: [PATCH] Add usage section to README

---
 README.md | 27 +++++++++++++++++++++++++++
 1 file changed, 27 insertions(+)

diff --git a/README.md b/README.md
index 28b8739..8263d84 100644
--- a/README.md
+++ b/README.md
@@ -1,3 +1,30 @@
 # parzig
 
 A Parquet parser written in Zig using only the standard library.
+
+## Usage
+
+```zig
+const parzig = @import("parzig");
+
+var file = try parzig.parquet.File.read(allocator, &file_reader);
+defer file.deinit();
+
+var rg = file.rowGroup(0);
+
+// Static typing: specify type at compile time
+const values = try rg.readColumn(i64, 0);
+const nullable = try rg.readColumn(?i64, 1);
+
+// Dynamic typing: type determined at runtime
+const dynamic = try rg.readColumnDynamic(0);
+switch (dynamic) {
+    .int64 => |data| // ...
+    .byte_array => |data| // ...
+    // ...
+}
+
+// Nested types
+const list = try rg.readListColumn(i32, 0);
+const map = try rg.readMapColumn([]const u8, i64, 0, 1);
+```