go.dev is live!

[Julie Qiu]

Hey Gophers, 

We are excited to share that go.dev, a new hub for Go developers, is now live!

At go.dev, you will find information on how to get started with the language, featured use cases, and other resources. It is a companion site to golang.org. You can read about it on the latest Go blog post.

You will also find a new place to discover Go packages and modules, pkg.go.dev, by clicking on Explore in the header or footer.

Pkg.go.dev serves Go documentation like godoc.org, but it also understands modules and has information about previous versions of a package (such as all releases of the Go standard library!). It also detects and displays licenses and has a better search algorithm.

You can follow Go issue 33654 for future developments on pkg.go.dev.

We are just starting to build out go.dev, so some bugs are to be expected. We want to work with all of you to make this site better for Go developers, so please share your feedback with us and file issues if you spot them! You can do that by clicking "Share Feedback" or "Report an Issue" at the footer of every page, or by emailing go-discove...@google.com. See go.dev/about for more information about the site.

We hope you enjoy the new site and look forward to hearing your feedback!

Warmly ☀️, 

Julie for the Go team

[Tyler Compton]

Thanks for posting! I'm really impressed the website, and with the package view especially. I foresee myself using this instead of godoc.org from now on.

I'm curious to hear more about the team's future plans for golang.org. Do you have any plans to migrate or mirror content like the blog or the download links over time? I could see some minor confusion popping up regarding which website to go to for which task, though I see this has been partially addressed by adding links to many of golang.org's resources on go.dev, which is thoughtful.

--
You received this message because you are subscribed to the Google Groups "golang-dev" group.
To unsubscribe from this group and stop receiving emails from it, send an email to golang-dev+...@googlegroups.com.
To view this discussion on the web visit https://groups.google.com/d/msgid/golang-dev/CAGJ2NqEcskx_492HFpV%3DUavMLgXoYmXaZ1ivigqnjfc-9U8wFA%40mail.gmail.com.

[Dan Kortschak]

Hi,

It looks like license detection needs work.

See https://pkg.go.dev/gonum.org/v1/gonum?tab=overview and note it has
a BSD 3 clause, as shown by GitHub's assessment (just above the "Clone
or download" button) at https://github.com/gonum/gonum and the LICENSE
file that it links to.

Dan

On Wed, 2019-11-13 at 12:12 -0500, 'Julie Qiu' via golang-dev wrote:
> Hey Gophers,
>
> We are excited to share that go.dev, a new hub for Go developers, is
> now
> live!
>
> At go.dev, you will find information on how to get started with the
> language, featured use cases, and other resources. It is a companion
> site
> to golang.org. You can read about it on the latest Go blog post

> <https://blog.golang.org/go.dev>.

>
> You will also find a new place to discover Go packages and modules,
> pkg.go.dev, by clicking on Explore in the header or footer.
>

> Pkg.go.dev <https://pkg.go.dev> serves Go documentation like

> godoc.org, but
> it also understands modules and has information about previous
> versions of
> a package (such as all releases of the Go standard library

> <https://pkg.go.dev/std?tab=versions>!). It also detects and displays

> licenses and has a better search algorithm.
>

> You can follow Go issue 33654 <https://golang.org/issue/33654> for

[Dan Kortschak]

Also, the license feedback link at https://pkg.go.dev/license-policy
fails to work on Firefox.

[Ian Davis]

On Thu, 14 Nov 2019, at 4:54 AM, Dan Kortschak wrote:
> Hi,
>
> It looks like license detection needs work.
>
> See https://pkg.go.dev/gonum.org/v1/gonum?tab=overview and note it has
> a BSD 3 clause, as shown by GitHub's assessment (just above the "Clone
> or download" button) at https://github.com/gonum/gonum and the LICENSE
> file that it links to.
>

It does seem that something is amiss with license detection. For example Github detects the use of the UNLICENSE just fine for https://github.com/iand/salience but go.dev misses it completely and refuses to display the readme.

[Jan Mercl]

On Thu, Nov 14, 2019 at 5:55 AM Dan Kortschak <d...@kortschak.io> wrote:

> It looks like license detection needs work.
>
> See https://pkg.go.dev/gonum.org/v1/gonum?tab=overview and note it has
> a BSD 3 clause, as shown by GitHub's assessment (just above the "Clone
> or download" button) at https://github.com/gonum/gonum and the LICENSE
> file that it links to.

Moreover, such packages seem to be, as a side effect, non-discoverable
because their README and documentation are not indexed (nor
displayed). For example, searching for `pure go SQL database' has zero
results.

I don't care about automatic license recognizing, even though it's
admittedly a useful information for the site user. But I don't
understand why projects with unrecognized LICENSE file contents don't
show the README and the documentation.

I'll better leave the fact of hiding even the LICENSE file per se from
the user with the message `“Licenses” hidden due to license
restrictions.` without comment because I guess it's just a legal issue
I don't understand.

Any yes, all my packages that I tried are victims to the above issues.
Here's an example of a recognized LICENSE vs an unrecognized one:

jnml@e5-1650:~/src/modernc.org/mathutil> diff -u ~/goroot/LICENSE LICENSE
--- /home/jnml/goroot/LICENSE 2019-09-10 14:24:54.469859557 +0200
+++ LICENSE 2019-09-10 14:36:43.347068286 +0200
@@ -1,4 +1,4 @@
-Copyright (c) 2009 The Go Authors. All rights reserved.
+Copyright (c) 2014 The mathutil Authors. All rights reserved.

Redistribution and use in source and binary forms, with or without
modification, are permitted provided that the following conditions are
@@ -10,7 +10,7 @@
copyright notice, this list of conditions and the following disclaimer
in the documentation and/or other materials provided with the
distribution.
- * Neither the name of Google Inc. nor the names of its
+ * Neither the names of the authors nor the names of the
contributors may be used to endorse or promote products derived from
this software without specific prior written permission.

jnml@e5-1650:~/src/modernc.org/mathutil>

[Dan Kortschak]

Yes. This is my exact concern.

This has two impacts, one is the non-discoverability and the other is a
possibility of misapprehension that the packages are in fact non-
licensed which is an actual harm to the packages. The irony is that we
have gone to excessive lengths to ensure that all our original sources
have their licenses represented as well.

[Mohamed Yousif]

Is there any plans on open sourcing go.dev (the webservices behind it). It is a little bit odd, but I'll personally learn a lot from it.

Oh, and congrats on the great work. I really liked it so much and would definitely use it a lot over godoc.

Regards,

M

--
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.
To view this discussion on the web visit https://groups.google.com/d/msgid/golang-nuts/7b8e08bb8429ac6b245458b33df597b783e0180b.camel%40kortschak.io.

[sbs.1...@gmail.com]

Hi, 

I am a Software Engineer working at a Fashion E-Commerce company in India. Golang has been a part of our journey for the last 2-3 years and has allowed us to scale massively in the past 2-3 years. Would it be okay if we send out an article regarding our journey with Golang over the past 2-3 years. 

Best regards,

Salman Shah. 

On Wednesday, November 13, 2019 at 10:46:46 PM UTC+5:30, Julie Qiu wrote:

Hey Gophers, 

We are excited to share that go.dev, a new hub for Go developers, is now live!

At go.dev, you will find information on how to get started with the language, featured use cases, and other resources. It is a companion site to golang.org. You can read about it on the latest Go blog post.

You will also find a new place to discover Go packages and modules, pkg.go.dev, by clicking on Explore in the header or footer.

Pkg.go.dev serves Go documentation like godoc.org, but it also understands modules and has information about previous versions of a package (such as all releases of the Go standard library!). It also detects and displays licenses and has a better search algorithm.

You can follow Go issue 33654 for future developments on pkg.go.dev.

We are just starting to build out go.dev, so some bugs are to be expected. We want to work with all of you to make this site better for Go developers, so please share your feedback with us and file issues if you spot them! You can do that by clicking "Share Feedback" or "Report an Issue" at the footer of every page, or by emailing go-discovery-feedback@google.com. See go.dev/about for more information about the site.

[marwan...@gmail.com]

Hi there,

Is there an issue to track when/if the code for pkg.go.dev will be open sourced? 

Happy to open an issue as I couldn't find one. 

Thank you! 

On Wednesday, November 13, 2019 at 12:16:46 PM UTC-5, Julie Qiu wrote:

Hey Gophers, 

We are excited to share that go.dev, a new hub for Go developers, is now live!

At go.dev, you will find information on how to get started with the language, featured use cases, and other resources. It is a companion site to golang.org. You can read about it on the latest Go blog post.

You will also find a new place to discover Go packages and modules, pkg.go.dev, by clicking on Explore in the header or footer.

Pkg.go.dev serves Go documentation like godoc.org, but it also understands modules and has information about previous versions of a package (such as all releases of the Go standard library!). It also detects and displays licenses and has a better search algorithm.

You can follow Go issue 33654 for future developments on pkg.go.dev.

We are just starting to build out go.dev, so some bugs are to be expected. We want to work with all of you to make this site better for Go developers, so please share your feedback with us and file issues if you spot them! You can do that by clicking "Share Feedback" or "Report an Issue" at the footer of every page, or by emailing go-discovery-feedback@google.com. See go.dev/about for more information about the site.