Hello, Since with release of Go 1.18 we will have Go's generics, I started a preparation tour around Go blog and YouTube. And here is one suggestion and one unimportant comment of mine about blog post "Why Generics?" (https://go.dev/blog/why-generics).
This post is in my opinion very valuable, fortunately Go team abandons change few ideas to better ones, like removing concept of "contracts" in the name of new functionality of interfaces. In such situation I propose to add at the top of the page text block saying "Caution. Implementation of generics in Go different from draft discussed here. To learn about actual implementation of generics check [link to relevant materials]." Now unimportant comment. At the end of the section "Ordered types" we have paragraph "In practice this contract would probably go into the standard library, and so really the Min function (which will probably also be in the standard library somewhere) will look like this. Here we’re just referring to the contract Ordered defined in the package contracts." All this text use one kind of font, which contrast with all the rest of the post. Names of Go functions such as "Min" and meta-types as "Ordered" to this point was always typed with different font. I think this is simple, unimportant mistake. Best, Kamil poniedziałek, 8 listopada 2021 o 14:54:39 UTC+1 Leam Hall napisał(a): > I agree with Kamil. Go is young and growing. Committing to keeping at > least the "official" blogs updated will help us on-board new gophers and > get them productive quickly. > > I appreciate the effort the Go team puts into the blogs and documents. How > can we make it easier and better? > > Leam > > On 11/8/21 06:03, Kamil Ziemian wrote: > > "Blog posts should really be viewed as a snapshot that is valid when > they're published (that's why they contain a date)" > > I agree, but since page that you are referring contains numbers of links > to Go Blog posts with description "The official blog of the Go project < > https://blog.golang.org/>, featuring news and in-depth articles by the Go > team and guests.", I feel that they should put this disclaimer on this page > or move links to posts to another page. "Using Go Module < > https://golang.org/blog/using-go-modules>" is among posts linked on > Documentation. > > > > Maybe there is a way to suggest such a simple change to this page to > people that maintain documentation? Or maybe this is over the top idea? > > > > Best > > Kamil > > > > pon., 8 lis 2021 o 12:31 Sean Liao <seank...@gmail.com <mailto: > seank...@gmail.com>> napisał(a): > > > > Blog posts should really be viewed as a snapshot that is valid when > they're published (that's why they contain a date) > > The guides under https://golang.org/doc/#getting-started < > https://golang.org/doc/#getting-started> however should be kept up to > date with the latest releases > > > > On Monday, November 8, 2021 at 11:24:48 AM UTC+1 kziem...@gmail.com > <mailto:kziem...@gmail.com> wrote: > > > > "Technically that behaviour is still available via GO111MODULE=auto. > > Go 1.16 changed the default from "auto" to "on"." > > > > Thank you for that information. It is surprisingly hard to me to learn > basic of Go and Go tools, when things don't works as described. > > > > I found few another places where "Using Go Modules" ( > https://go.dev/blog/using-go-modules <https://go.dev/blog/using-go-modules>) > is not up to date with out of box Go version 1.17.2. > > > > 1) According to part "Adding a dependency" (end of fourth block of text) > "Only direct dependencies are recorded in the go.mod file". But my go.mod > file contains lines. > > > > require ( > > golang.org/x/text <http://golang.org/x/text> > v0.0.0-20170915032832-14c0d48ead0c // indirect > > rsc.io/sampler <http://rsc.io/sampler> v1.3.0 // indirect > > ) > > > > 2) After using "go get golang.org/x/text <http://golang.org/x/text>" > command "go list -m all" I get one line more that in blog post > > > > golang.org/x/tools <http://golang.org/x/tools> > v0.0.0-20180917221912-90fa682c2a6e > > > > 3) After function TestProverb(t *testing.T) is and running "go test" > (I'm quite sure that when I did this few years ago, this was the command > that I used) I get > > > > hello.go:5:2: no required module provides package rsc.io/quote/v3 < > http://rsc.io/quote/v3>; to add it: > > go get rsc.io/quote/v3 <http://rsc.io/quote/v3> > > > > This is easy to solve by running "go get rsc.io/quote/v3 < > http://rsc.io/quote/v3>", but still annoying when you are going through > this post. > > > > Best > > Kamil > > niedziela, 31 października 2021 o 00:29:57 UTC+2 Kamil Ziemian > napisał(a): > > > > This is probably silly thing, but I will write it down just in case. > > > > I mentioned before Go blog post "Using Go Modules" ( > https://go.dev/blog/using-go-modules <https://go.dev/blog/using-go-modules>), > we first write a function > > > > func Hello() string { > > return "Hello, world." > > } > > > > and test for it which basically check condition > > > > Hello() == "Hello, world." > > > > In the next step we change our function to > > > > func Hello() string { > > return quote.Hello() > > } > > > > using the module "rsc.io/quote <http://rsc.io/quote>". But this is "not > portable example" and when test on my computer PASS when using the first > version of our Hello() function, it FAILS with the second. > > > > According to description quote.Hello() ( > https://pkg.go.dev/rsc.io/quote#Hello < > https://pkg.go.dev/rsc.io/quote#Hello>), but from source code we know > that in fact it returns a string returned by sampler.Hello(prefs > ...language.Tag). The last function "returns a localized greeting. If no > prefs are given, Hello uses DefaultUserPrefs." ( > https://pkg.go.dev/rsc.io/sampler#Hello < > https://pkg.go.dev/rsc.io/sampler#Hello>). > > > > On my computer it correctly detected polish language so quote.Hello() > returns "Witaj świecie." and since "Witaj świecie." != "Hello, world." the > test now fails. > > > > Best > > Kamil > > > > sob., 30 paź 2021 o 23:28 Sean Liao <seank...@gmail.com> napisał(a): > > > > Technically that behaviour is still available via GO111MODULE=auto. > > Go 1.16 changed the default from "auto" to "on". > > > > On Saturday, October 30, 2021 at 11:17:05 PM UTC+2 kziem...@gmail.com > wrote: > > > > Hello, > > > > I don't have energy today to read Go language spec or learning how UTF-8 > works, so I decided to make a look at Go blog post "Using Go Modules" ( > https://go.dev/blog/using-go-modules <https://go.dev/blog/using-go-modules>). > I have a simple question: is this post up to date? > > > > I guess not, here is my reason why. According to it if I run command "go > test" outside $GOPATH and in director without go.mod file I should get > result similar to > > > > PASS > > ok _/some path/hello 0.020s > > > > When I run it with my go version go1.17.1 linux/amd64, result is > > > > go: go.mod file not found in current directory or any parent directory; > see 'go help modules' > > > > This is one of the Go blog post listed on Documentation page ( > https://golang.org/doc/ <https://golang.org/doc/>), so I guess it should > have note "If you use Go in version x.y.z or latter, some code may not > work", but maybe I just think about it in the wrong way. > > > > From practical reason this particular thing isn't important, because > go.mod file is the way to go (or at least this is what I read in the last > week). > > > > Best > > Kamil > > > > wtorek, 7 września 2021 o 22:23:19 UTC+2 Ian Lance Taylor napisał(a): > > > > On Tue, Sep 7, 2021 at 3:40 AM Kamil Ziemian <kziem...@gmail.com> wrote: > > > > > > In the post "Concurrency is not parallelism" by Andrew Gerrand ( > https://go.dev/blog/waza-talk <https://go.dev/blog/waza-talk>) under the > paragraph starting with "To clear up this conflation, Rob Pike gave a talk > at Heroku’s Waza" in my browser is big blank space. I believe that that I > can see rectangle in it, with slightly different hue of with, but I can't > be sure. > > > > > > Is it my browser not working or something goes wrong with the page? > Can someone check if he/she has the same problem? I use Mozilla Firefox for > Ubuntu canonical - 1.0, version 91.0.2 (64 bits). I hope I don't mess up > Fierfox data. > > > > Thanks, sent https://golang.org/cl/348013 <https://golang.org/cl/348013> > to fix this. > > > > Ian > > > > -- > > You received this message because you are subscribed to a topic in the > Google Groups "golang-nuts" group. > > To unsubscribe from this topic, visit > https://groups.google.com/d/topic/golang-nuts/p4YTbDqTUhI/unsubscribe < > https://groups.google.com/d/topic/golang-nuts/p4YTbDqTUhI/unsubscribe>. > > To unsubscribe from this group and all its topics, send an email to > golang-nuts...@googlegroups.com. > > To view this discussion on the web visit > https://groups.google.com/d/msgid/golang-nuts/fce2cfcc-993d-4c25-8863-484b67b02870n%40googlegroups.com > > < > https://groups.google.com/d/msgid/golang-nuts/fce2cfcc-993d-4c25-8863-484b67b02870n%40googlegroups.com?utm_medium=email&utm_source=footer > >. > > > > -- > > You received this message because you are subscribed to a topic in the > Google Groups "golang-nuts" group. > > To unsubscribe from this topic, visit > https://groups.google.com/d/topic/golang-nuts/p4YTbDqTUhI/unsubscribe < > https://groups.google.com/d/topic/golang-nuts/p4YTbDqTUhI/unsubscribe>. > > To unsubscribe from this group and all its topics, send an email to > golang-nuts...@googlegroups.com <mailto:golang-nuts...@googlegroups.com>. > > To view this discussion on the web visit > https://groups.google.com/d/msgid/golang-nuts/dabd7534-8aed-4590-96c7-a767d9e5cbcen%40googlegroups.com > > < > https://groups.google.com/d/msgid/golang-nuts/dabd7534-8aed-4590-96c7-a767d9e5cbcen%40googlegroups.com?utm_medium=email&utm_source=footer > >. > > > > -- > > You received this message because you are subscribed to the Google > Groups "golang-nuts" group. > > To unsubscribe from this group and stop receiving emails from it, send > an email to golang-nuts...@googlegroups.com <mailto: > golang-nuts...@googlegroups.com>. > > To view this discussion on the web visit > https://groups.google.com/d/msgid/golang-nuts/CAB3gO8ow0PBi%3DRCoxiRSjeEBgUTrWW3dm%2BvzEvr_pdsybwg-nQ%40mail.gmail.com > > < > https://groups.google.com/d/msgid/golang-nuts/CAB3gO8ow0PBi%3DRCoxiRSjeEBgUTrWW3dm%2BvzEvr_pdsybwg-nQ%40mail.gmail.com?utm_medium=email&utm_source=footer > >. > > -- > Systems Programmer (reuel.net/resume) > Scribe: The Domici War (domiciwar.net) > General Ne'er-do-well (github.com/LeamHall) > -- You received this message because you are subscribed to the Google Groups "golang-nuts" group. To unsubscribe from this group and stop receiving emails from it, send an email to golang-nuts+unsubscr...@googlegroups.com. To view this discussion on the web visit https://groups.google.com/d/msgid/golang-nuts/ea713d05-7fc3-48c8-a35a-564eb6536e08n%40googlegroups.com.
