// the find
astaxie/gopkg
example for the go pkg's function
A community-built reference of Go standard library usage examples, one Markdown file per function. Started by astaxie (beego author) to fill the gap where the official docs had too few examples. Aimed at Go beginners and intermediate developers who find the stdlib docs too terse.
Covers an unusually wide slice of the stdlib — bufio, bytes, compress, crypto, container, encoding and more — with runnable examples verified against the playground. The one-file-per-function structure makes it easy to find exactly what you're looking for without reading surrounding noise. Some packages (base32, base64) include actual test files alongside the Markdown, so the examples are executable and checkable, not just illustrative prose.
The README is in Chinese and the project coordination (todo list, contribution channel) lives in a QQ group, which limits discoverability and participation for non-Chinese developers. Last meaningful activity was 2024 but the content largely targets older Go versions — nothing here on generics, the new log/slog package, or post-1.18 additions that are now the idiomatic way to write Go. Many packages (database/sql, crypto/tls, debug/*) have directory placeholders with empty READMEs and no actual examples, so coverage is uneven in ways that aren't obvious until you go looking.