Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

x/pkgsite: pkg.go.dev tracking issue #33654

Closed
julieqiu opened this issue Aug 14, 2019 · 8 comments
Closed

x/pkgsite: pkg.go.dev tracking issue #33654

julieqiu opened this issue Aug 14, 2019 · 8 comments

Comments

@julieqiu
Copy link
Member

This is the tracking issue for the Go discovery site, previously announced in the Go Modules in 2019 blog post. The parent umbrella issue for all “godoc”-like projects is #26827.

The website will display documentation for Go packages with version support and provide features that help developers discover and evaluate Go packages or modules.

The discovery site is currently in development. We are working towards launching by the end of the year.

As mentioned in golang/gddo#567 (comment), some early mockups of the discovery site were first shared in the "Finding Dependable Go Packages" talk (slides) at GothamGo 2019 (video). These can be seen starting at slide 92.

If you are interested in this topic, please subscribe to this issue. We will use it to post future updates. You can also find us in the #tools channel on the Gophers Slack.

@julieqiu julieqiu added NeedsFix The path to resolution is known, but the work has not been done. modules labels Aug 14, 2019
@julieqiu julieqiu added this to the Unreleased milestone Aug 14, 2019
@julieqiu julieqiu self-assigned this Aug 14, 2019
@golang golang locked and limited conversation to collaborators Aug 14, 2019
@golang golang unlocked this conversation Aug 21, 2019
@golang golang locked and limited conversation to collaborators Aug 21, 2019
@julieqiu
Copy link
Member Author

julieqiu commented Nov 13, 2019

The discovery site is now live at pkg.go.dev!

You can read about it on the latest Go blog post.

We hope that you will try it out, and we would love to hear your feedback! We are just getting started with building out pkg.go.dev, so some bugs are to be expected. Please file any issues and share your thoughts with us by clicking "Share Feedback" or "Report an Issue" in the footer of every page , or by emailing <removed>.

We look forward to hearing everyone’s feedback!

@julieqiu
Copy link
Member Author

julieqiu commented Nov 26, 2019

We would love to know if your organization is running an internal Go documentation service, to inform our open source strategy for pkg.go.dev.

If this is something that your organization is currently doing, please share your use case with us by sending an email to <removed>, or filling out the Go Developer survey.

@julieqiu
Copy link
Member Author

julieqiu commented Dec 30, 2019

We recently updated pkg.go.dev/license-policy to include our list of accepted licenses, and to clarify that we use github.com/google/licensecheck for license detection. If you still have questions about your license, feel free to file an issue email <removed>.

We plan to respond to all issues in the new year, and to continue working with our legal team to resolve any license issues. Thanks for being patient with us as we work through them!

@julieqiu julieqiu changed the title discovery: Go discovery site tracking issue pkg.go.dev: Go discovery site tracking issue Jan 22, 2020
@julieqiu
Copy link
Member Author

Thanks to everyone for all the feedback so far on go.dev!

We’ve read it all, and it’s helping us to make the site better.

A few themes have emerged, and one of them is about feedback itself. Many of you have pointed out that certain types of discussion would be better served by a public issue tracker.

For that reason, we're opening up the Go issue tracker as an additional channel for feedback for go.dev. The issue tracker is useful to post issues that you think would be relevant to other members of the Go community, and to share features and issues that you would like to have discussed on a public forum.

Feel free to start sharing your ideas on the Go issue tracker! Please prefix your issues with go.dev:.

You can continue sending us feedback via our current channels:

We look forward to hearing your feedback!

@julieqiu julieqiu added pkgsite and removed NeedsFix The path to resolution is known, but the work has not been done. labels Jan 28, 2020
@julieqiu
Copy link
Member Author

julieqiu commented Jan 31, 2020

We are planning to redirect traffic from godoc.org to pkg.go.dev, and want to hear your feedback on what you want to see on pkg.go.dev! For details, see the Next steps for pkg.go.dev blog post.

You can share your feedback with us by:

  • Posting on the Go issue tracker
  • Email <removed>
  • Clicking “Share Feedback” or“Report an Issue” in the footer on the site

@gopherbot
Copy link

Change https://golang.org/cl/217539 mentions this issue: devapp/owners, internal/gophers: add owners for {pkg,learn,}.go.dev

@julieqiu
Copy link
Member Author

julieqiu commented Feb 14, 2020

You can now redirect your own requests from godoc.org to pkg.go.dev, by visiting godoc.org?redirect=on.

This will set a cookie in your browser, so that any request you make to godoc.org will be redirected to pkg.go.dev.

If you want to turn this feature off, you can do so by visiting godoc.org?redirect=off.

Thanks to @jamalc for this contribution! (Go issue 37099)

@julieqiu julieqiu changed the title pkg.go.dev: Go discovery site tracking issue x/pkgsite: pkg.go.dev tracking issue Jun 15, 2020
@julieqiu
Copy link
Member Author

Closing this tracking issue, as information on the project direction will be shared in the x/pkgsite README Roadmap.

Additionally, the following milestones are used to track work for 2020:

Sign up for free to subscribe to this conversation on GitHub. Already have an account? Sign in.
Projects
None yet
Development

No branches or pull requests

2 participants