--- title: "GoDoc Playground: Experiment with GoDoc Formatting in Real Time" publication: "Go Weekly" issue: 234 published_at: "2018-10-25" canonical_url: "https://golangweekly.com/issues/234" --- The latest Golang development news #234 — October 25, 2018 [Read on the Web](https://golangweekly.com/issues/234) Golang Weekly [![\](https://res.cloudinary.com/cpress/image/upload/w_1280,e_sharpen:60/hlxv5srk28nwpevwn5mv.jpg)](https://bradleyjkemp.github.io/godoc-playground/) [GoDoc Playground: Experiment with GoDoc Formatting in Real Time](https://bradleyjkemp.github.io/godoc-playground/) — A neat online tool for playing with the GoDoc code documentation syntax and seeing how changes affect things in real time. Sure, you can do this locally, but I find doing things with a real time update really helps the learning process. Bradley Kemp [Proposal: Make Incompatible Changes From Go 1 to Go 2 Breaking As Little As Possible](https://github.com/golang/proposal/blob/master/design/28221-go2-transitions.md) — _“If the [proposal](https://github.com/golang/proposal/blob/master/design/28221-go2-transitions.md) works as planned, then in an important sense there never will be a Go 2. Or, to put it a different way, we will slowly transition to new language and library features.”_ Rather than break things for a fresh new version 2, gradual improvements could make life easier. Ian Lance Taylor [![\](https://copm.s3.amazonaws.com/b6a9d71b.png)](https://circleci.com/blog/level-up-go-test-with-gotestsum/?utm_source=cooperpress&utm_medium=newsletter&utm_campaign=oct18&utm_content=go-newsletter) [Level Up ‘go test’ with ‘gotestsum’](https://circleci.com/blog/level-up-go-test-with-gotestsum/?utm_source=cooperpress&utm_medium=newsletter&utm_campaign=oct18&utm_content=go-newsletter) — How to make the output of go tests more useful for local development as well as for CircleCI. CircleCI sponsor [Go 101: An Online Guide to Go Syntax and Semantics](https://go101.org/article/tips.html) — An online book aimed at developers who want to poke around with some of the details of Go. The [tips](https://go101.org/article/tips.html) and [details](https://go101.org/article/details.html) pages are where the bulk of the value is. TapirLiu [Participate in the 2018 Go Company Questionnaire](https://blog.golang.org/company-questionnaire2018) — The core Go team are keen to hear from you if you work at a _company_ using Go. It’s a 7 minute questionnaire that will help them improve the experience for commercial users. Closes October 30th. Ran Tao and Steve Francia PDF: [The Past, Present, and Future of Go 2](https://dave.cheney.net/paste/the-past-present-and-future-of-go2.pdf) — Yes, a slidedeck, but packed with interesting info and examples. Dave Cheney ▶[CSVQL: Building Something to Serve CSV with SQL](https://www.youtube.com/watch?v=bcRDXAraprk) — Francesc and his popular JustForFunc series are back - this time he starts work on a simple SQL-based frontend for serving up CSV-based data using [go-mysql-server](https://github.com/src-d/go-mysql-server) Francesc Campoy 💻 Jobs [Architect, Senior Software Engineer - Subscriptions (SF)](https://jobs.lever.co/twitch/88db8123-cd6b-437e-aabf-7acec6df54d7) — Operating at massive scale, Twitch Subs is seeking a Senior Architect to experiment, build and scale solutions across our organization. Twitch [Join Our Career Marketplace & Get Matched With A Job You Love](https://www.hired.com/gonews) — Through Hired, software engineers have transparency into salary offers, competing opportunities, and job details. Hired 📘 Tutorials [Reverse Geocoding Coordinates to Addresses in Go](https://developer.here.com/blog/reverse-geocoding-coordinates-to-addresses-with-the-go-programming-language) Nic Raboy [How to Build a Single-Page App with Go and Vue](https://developer.okta.com/blog/2018/10/23/build-a-single-page-app-with-go-and-vue) — Learn how to build comprehensive single-page apps using Go and Vue. Kleber Correia [Refactorings in GoLand IDE: Deep Code Insight and Smart Undo](https://blog.jetbrains.com/go/2018/10/19/refactorings-change-signature/) — Learn how these essential development tasks can be performed safer & quicker. JetBrains sponsor [Go Concurrency Patterns](https://blog.afoolishmanifesto.com/posts/golang-concurrency-patterns/) — A couple of patterns to leverage for different use cases along with some solid advice. Frew Schmidt ▶[Creating a Fake 3D Tunnel Effect in Go](https://www.youtube.com/watch?v=OETspf9Th2Y) — One for the creative/graphics programmers, particularly if you dig 90s-style demo effects. Fun! GO AFTER DARK [Doing Well by Doing Bad: Writing Bad Code with Go](https://medium.com/capital-one-tech/doing-well-by-doing-bad-writing-bad-code-with-go-part-1-2dbb96ce079a) — Perhaps less a tutorial and more a _satirical_ take on ways to make your Go code worse. Sometimes it’s valuable to reflect on what _not_ to do(!) Jon Bodner [How to Black Box Test a Go App with.. Ruby!?](https://medium.freecodecamp.org/how-to-black-box-test-a-go-app-with-rspec-421e786f4103) — This approach might suit you if Ruby is in your stack and you have a rather specific use case.. Dmitriy Lutsko ▶[How Do You Structure Your Go Apps?](https://www.youtube.com/watch?v=B5oQnECDJ8g) — There is almost always more than one answer and it can be tricky to decide what will work best. _43 mins_. Kat Zien [Using `go mod download` to Speed Up Go Docker Builds](https://medium.com/@petomalina/using-go-mod-download-to-speed-up-golang-docker-builds-707591336888) Peter Malina 🔧Code & Tools [Ebiten: A Simple 2D Game Library for Go](https://github.com/hajimehoshi/ebiten) — The [latest release](https://github.com/hajimehoshi/ebiten/releases/tag/v1.8.0) includes an experimental WebAssembly port, polygon support, and multi monitor support. Hajime Hoshi [Using Heptio Ark to Back Up and Restore Kubernetes Objects on DigitalOcean](https://www.digitalocean.com/community/tutorials/how-to-back-up-and-restore-a-kubernetes-cluster-on-digitalocean-using-heptio-ark?utm_source=paid_newsletter+go+weekly&utm_medium=display&utm_campaign=2018_Brant&utm_content=10-25-18+go+weekly+cooperpress) DigitalOcean sponsor [Litter: A Pretty Printer for Go Data Structures](https://github.com/sanity-io/litter) — Handy for debugging and testing. Sanity [Godown: A Distributed, Fault-Tolerant Key-Value Store Built in Go](https://github.com/namreg/godown) — Uses the Raft protocol for consensus and natively supports strings, bitmaps, maps, and lists. Igor German [progressbar: A Basic, Thread-Safe Progress Bar](https://github.com/schollz/progressbar) Zack Scholl [movingtriangle: A Basic Example of Using macOS's Metal API from Go](https://dmitri.shuralyov.com/gpu/mtl/example/movingtriangle) — Metal is a low-level 3D graphic and compute shader API programming interface. The [code](https://gotools.org/dmitri.shuralyov.com/gpu/mtl/example/movingtriangle) is reasonably straightforward. Dmitri Shuralyov [Ultimate Plumber: A Tool for Creating Linux Pipes with Instant Live Preview](https://github.com/akavel/up) — It’s increasingly the case we’re linking to cool things _built with_ Go than Go libraries themselves and this is no exception. Mateusz Czapliński [resty: Simple HTTP and REST Client Library for Go](https://github.com/go-resty/resty) Jeevanandam M. Curated by [Glenn Goodrich](https://twitter.com/ruprict) and [Peter Cooper](https://twitter.com/peterc) [Change your email address](https://golangweekly.com/edit_subscription/*|UID|*) or[Stop getting this newsletter](https://golangweekly.com/leave/*|UID|*) © Cooper Press Ltd · Fairfield Enterprise Centre, Louth, LN11 0LS, United Kingdom