diff --git a/.cache/plugin/social/e4eb5bc578adbed8e1467370dc660724.png b/.cache/plugin/social/e4eb5bc578adbed8e1467370dc660724.png new file mode 100644 index 0000000..1601452 Binary files /dev/null and b/.cache/plugin/social/e4eb5bc578adbed8e1467370dc660724.png differ diff --git a/docs/book.md b/docs/book.md index e2d1273..df484d5 100644 --- a/docs/book.md +++ b/docs/book.md @@ -5,15 +5,13 @@ hide: # 100 Go Mistakes and How to Avoid Them -Community space of 📖 _100 Go Mistakes and How to Avoid Them_, published by Manning in 2022. - ![](img/cover.png) ## Description -If you're a Go developer looking to improve your skills, this book is for you. With a focus on practical examples, _100 Go Mistakes and How to Avoid Them_ covers a wide range of topics from concurrency and error handling to testing and code organization. You'll learn to write more idiomatic, efficient, and maintainable code and become a proficient Go developer. +If you're a Go developer looking to improve your skills, the _100 Go Mistakes and How to Avoid Them_ book is for you. With a focus on practical examples, this book covers a wide range of topics from concurrency and error handling to testing and code organization. You'll learn to write more idiomatic, efficient, and maintainable code and become a proficient Go developer. -Read a summary of the 100 mistakes [here](https://100go.co). +Read a [summary](index.md) of the 100 mistakes or the [first chapter](chapter-1.md). ## Quotes and Ratings @@ -43,17 +41,21 @@ Read a summary of the 100 mistakes [here](https://100go.co). ## Where to Buy? * _100 Go Mistakes and How to Avoid Them_ (🇬🇧 edition: paper, digital, or audiobook) - * [Manning](https://www.manning.com/books/100-go-mistakes-and-how-to-avoid-them) (make sure to use my personal discount code for -35%: `au35har`) + * [Manning](https://www.manning.com/books/100-go-mistakes-and-how-to-avoid-them) (please make sure to use my personal discount code for -35%: `au35har`) * [O’Reilly](https://www.oreilly.com/library/view/100-go-mistakes/9781617299599/) * Amazon: [.com](https://www.amazon.com/dp/1617299596), [.co.uk](https://www.amazon.co.uk/dp/B0BBSNJR6B), [.de](https://www.amazon.de/dp/B0BBHQD8BQ), [.fr](https://www.amazon.fr/100-Mistakes-How-Avoid-Them/dp/1617299596), [.in](https://www.amazon.in/dp/B0BBHQD8BQ), [.co.jp](https://www.amazon.co.jp/dp/B0BBHQD8BQ), [.es](https://www.amazon.es/dp/B0BBHQD8BQ), [.it](https://www.amazon.it/dp/B0BBHQD8BQ), [.com.br](https://www.amazon.com.br/dp/B0BBHQD8BQ) * _Go言語100Tips 開発者にありがちな間違いへの対処法_ (🇯🇵 edition: paper or digital) * Amazon: [.co.jp](https://www.amazon.co.jp/exec/obidos/ASIN/4295017531/) +* _100个Go语言典型错误_ (🇨🇳 edition: paper or digital) + * [Douban.com](https://read.douban.com/ebook/455919353/) +
![](img/cover-en.jpg){width="200"} ![](img/cover-jp.jpg){width="200"} -
English and Japanese covers
+ ![](img/cover-cn.jpg){width="170"} +
Covers
## About the Author diff --git a/docs/external.md b/docs/external.md index 50e0cd0..3d23baf 100644 --- a/docs/external.md +++ b/docs/external.md @@ -1,30 +1,70 @@ ---- -hide: -- toc ---- - # External Resources ## English -* Book Review: 100 Go Mistakes and How to Avoid Them: [Post](https://boldlygo.tech/posts/2023-08-09-review-100-go-mistakes/), [YouTube](https://www.youtube.com/watch?v=tcRYU9g5wtw) -* The Most Useful Book for a Go Programmer?: [YouTube](https://www.youtube.com/watch?v=8pqgv4_Yjq0) -* How to make mistakes in Go - Go Time #190: [Episode](https://changelog.com/gotime/190), [Spotify](https://open.spotify.com/episode/0K1DImrxHCy6E7zVY4AxMZ?si=akroInsPQ1mM5B5V2tHLUw&dl_branch=1) -* [8LU - 100% Test Coverage](https://youtu.be/V3FBDav6wgQ?t=1210) -* [Some Tips I learned from 100 Mistakes in Go](https://raygervais.dev/articles/2023/04/100_mistakes_in_go/) -* [What can be summarized from 100 Go Mistakes?](https://www.sobyte.net/post/2023-05/summarized-from-100-go-mistakes/) +### The Best Golang Book | Prime Reacts + + + +### Book Review: 100 Go Mistakes (And How to Avoid Them) + + + +[Post](https://boldlygo.tech/posts/2023-08-09-review-100-go-mistakes/) + +### The Most Useful Book for a Go Programmer? + + + +### How to make mistakes in Go - Go Time #190 + + + +* [Episode](https://changelog.com/gotime/190) +* [Spotify](https://open.spotify.com/episode/0K1DImrxHCy6E7zVY4AxMZ?si=akroInsPQ1mM5B5V2tHLUw&dl_branch=1) + +### Go is AMAZING + + + +### 8LU - 100% Test Coverage + + + +### Some Tips I learned from 100 Mistakes in Go + +[Post](https://raygervais.dev/articles/2023/04/100_mistakes_in_go/) + +### What can be summarized from 100 Go Mistakes? + +[Post](https://www.sobyte.net/post/2023-05/summarized-from-100-go-mistakes/) ## Chinese -* [深度阅读之《100 Go Mistakes and How to Avoid Them](https://qcrao.com/post/100-go-mistakes-reading-notes/) -* [100 Go Mistakes 随记](https://zhuanlan.zhihu.com/p/592602656) -* [我为什么放弃Go语言?](https://juejin.cn/post/7241452578125824061) +### 深度阅读之《100 Go Mistakes and How to Avoid Them + +[Post](https://qcrao.com/post/100-go-mistakes-reading-notes/) + +### 100 Go Mistakes 随记 + +[Post](https://zhuanlan.zhihu.com/p/592602656) + +### 我为什么放弃Go语言? + +[Post](https://juejin.cn/post/7241452578125824061) ## Japanese -* [最近読んだGo言語の本の紹介:100 Go Mistakes and How to Avoid Them](https://qiita.com/kentaro_suzuki/items/c9c31dc81217f237433c) -* [『100 Go Mistakes and How to Avoid Them』を読む](https://zenn.dev/yukibobier/books/066f07c8a59fa0) +### 最近読んだGo言語の本の紹介:100 Go Mistakes and How to Avoid Them + +[Post](https://qiita.com/kentaro_suzuki/items/c9c31dc81217f237433c) + +### 『100 Go Mistakes and How to Avoid Them』を読む + +[Post](https://zenn.dev/yukibobier/books/066f07c8a59fa0) ## Portuguese -* [Um ÓTIMO livro para programadores Go](https://www.youtube.com/watch?v=34XShL_jWD4) +### Um ÓTIMO livro para programadores Go + + diff --git a/docs/img/cover-cn.jpg b/docs/img/cover-cn.jpg new file mode 100644 index 0000000..4527551 Binary files /dev/null and b/docs/img/cover-cn.jpg differ diff --git a/docs/index.md b/docs/index.md index f1007de..a21f67d 100644 --- a/docs/index.md +++ b/docs/index.md @@ -4,11 +4,11 @@ comments: true # Common Go Mistakes -This page is a summary of all the mistakes in the 100 Go Mistakes book. Meanwhile, it's also a page open to the community. If you believe that a mistake should be added, please create a [community mistake issue](https://github.com/teivah/100-go-mistakes/issues/new?assignees=&labels=community+mistake&template=community_mistake.md&title=). +This page is a summary of the mistakes in the [100 Go Mistakes and How to Avoid Them book](book.md). Meanwhile, it's also open to the community. If you believe that a common Go mistake should be added, please create an [issue](https://github.com/teivah/100-go-mistakes/issues/new?assignees=&labels=community+mistake&template=community_mistake.md&title=). ???+ warning - You're currently viewing a new version that I'm enriching with significantly more content. Yet, this version is still under development; please be gentle if you find an issue, and feel free to create a PR. + You're viewing a new version enriched with significantly more content. However, this version is not yet complete, and we're looking for volunteers to summarize the remaining mistakes ([GitHub issue #43](https://github.com/teivah/100-go-mistakes/issues/43)). ![](img/inside-cover.png) @@ -236,10 +236,10 @@ func WithPort(port int) Option { } } -func NewServer(addr string, opts ...Option) ( *http.Server, error) { <1> - var options options <2> - for _, opt := range opts { <3> - err := opt(&options) <4> +func NewServer(addr string, opts ...Option) ( *http.Server, error) { + var options options + for _, opt := range opts { + err := opt(&options) if err != nil { return nil, err } @@ -2133,3 +2133,11 @@ Read the full section [here](98-profiling-execution-tracing.md). ???+ info "TL;DR" To help avoid CPU throttling when deployed in Docker and Kubernetes, keep in mind that Go isn’t CFS-aware. + +## Community + +Thanks to all the contributors: + + + Description of the image + diff --git a/mkdocs.yml b/mkdocs.yml index a9af223..9c609c5 100644 --- a/mkdocs.yml +++ b/mkdocs.yml @@ -65,7 +65,7 @@ nav: - book.md - chapter-1.md - external.md - - ⭐ Go Mistakes: + - 💡️ Go Mistakes: - index.md - Full Sections: - 9-generics.md diff --git a/overrides/main.html b/overrides/main.html deleted file mode 100644 index 587eb85..0000000 --- a/overrides/main.html +++ /dev/null @@ -1,5 +0,0 @@ -{% extends "base.html" %} - -{% block htmltitle %} - 100 Go Mistakes -{% endblock %} \ No newline at end of file diff --git a/site/20-slice/index.html b/site/20-slice/index.html index 99718bf..003a152 100644 --- a/site/20-slice/index.html +++ b/site/20-slice/index.html @@ -21,8 +21,10 @@ - 100 Go Mistakes - + + Not understanding slice length and capacity (#20) - 100 Go Mistakes and How to Avoid Them + + @@ -319,7 +321,7 @@ - ⭐ Go Mistakes + 💡️ Go Mistakes @@ -522,7 +524,7 @@ - ⭐ Go Mistakes + 💡️ Go Mistakes @@ -532,7 +534,7 @@