add intro

README.md

@@ -0,0 +1 @@
+src/README.md

src/README.md

@@ -0,0 +1,26 @@
+# Zig Cookbook
+
+[![](https://github.com/zigcc/zig-cookbook/actions/workflows/ci.yml/badge.svg)](https://github.com/zigcc/zig-cookbook/actions/workflows/ci.yml)
+[![](https://github.com/zigcc/zig-cookbook/actions/workflows/pages.yml/badge.svg)](https://github.com/zigcc/zig-cookbook/actions/workflows/pages.yml)
+
+[Zig cookbook](https://zigcc.github.io/zig-cookbook/) is a collection of simple Zig programs that demonstrate good practices to accomplish common programming tasks.
+
+# How to run
+
+Each tips is accompanied by an illustrative example named after its corresponding sequence number. These examples can be executed using the command `zig build run-{number}`, or `zig build run-all` to execute all.
+
+> Currently 0.11.0 is required to run those examples.
+
+# Contributing
+
+Anyone is welcome to contribute, and this project use [prettier](https://prettier.io/) to format markdown files, make sure to execute `make lint` before open new PR.
+
+# Acknowledgment
+
+When working on zig-cookbook, we benefit a lot from several similar projects, thanks for their awesome work.
+
+- [Rust Cookbook](https://github.com/rust-lang-nursery/rust-cookbook)
+
+# License
+
+[CC BY-NC-ND 4.0 DEED](https://creativecommons.org/licenses/by-nc-nd/4.0/)

src/SUMMARY.md

@@ -1,5 +1,6 @@
 # Summary
 
+- [Introduction](./README.md)
 - [File System]()
   - [Read file line by line](./01-01-read-file-line-by-line.md)
   - [Mmap file](./01-02-mmap-file.md)