Update README

README.md

@@ -1,2 +1,57 @@
 # perp
-Go per P cache 
+
+[![build-img]][build-url]
+[![pkg-img]][pkg-url]
+[![reportcard-img]][reportcard-url]
+[![coverage-img]][coverage-url]
+[![version-img]][version-url]
+
+Go per processor.
+
+## Rationale
+
+TODO
+
+## Features
+
+* Simple API.
+* Clean and tested code.
+* Optimized for speed.
+* Concurrent-safe.
+* Dependency-free.
+
+See [GUIDE.md](https://github.com/go-perf/perp/blob/main/GUIDE.md) for more details.
+
+## Install
+
+Go version 1.17+
+
+```
+go get github.com/go-perf/perp
+```
+
+## Example
+
+```go
+```
+
+Also see examples: [example_test.go](https://github.com/go-perf/perp/blob/main/example_test.go).
+
+## Documentation
+
+See [these docs][pkg-url].
+
+## License
+
+[MIT License](LICENSE).
+
+[build-img]: https://github.com/go-perf/perp/workflows/build/badge.svg
+[build-url]: https://github.com/go-perf/perp/actions
+[pkg-img]: https://pkg.go.dev/badge/go-perf/perp/v4
+[pkg-url]: https://pkg.go.dev/github.com/go-perf/perp/v4
+[reportcard-img]: https://goreportcard.com/badge/go-perf/perp
+[reportcard-url]: https://goreportcard.com/report/go-perf/perp
+[coverage-img]: https://codecov.io/gh/go-perf/perp/branch/main/graph/badge.svg
+[coverage-url]: https://codecov.io/gh/go-perf/perp
+[version-img]: https://img.shields.io/github/v/release/go-perf/perp
+[version-url]: https://github.com/go-perf/perp/releases