blob: 76454620f75a3d39dd9f17d72dbe5eb277213525 [file] [log] [blame] [view]
# golang.org/x/pkgsite
This repository hosts the source code of the [pkg.go.dev](https://pkg.go.dev) website,
and [`pkgsite`](https://pkg.go.dev/golang.org/x/pkgsite/cmd/pkgsite), a documentation
server program.
[![Go Reference](https://pkg.go.dev/badge/golang.org/x/pkgsite.svg)](https://pkg.go.dev/golang.org/x/pkgsite)
## pkg.go.dev: a site for discovering Go packages
Pkg.go.dev is a website for discovering and evaluating Go packages and modules.
You can check it out at [https://pkg.go.dev](https://pkg.go.dev).
## pkgsite: a documentation server
`pkgsite` program extracts and generates documentation for Go projects.
Example usage:
```
$ go install golang.org/x/pkgsite/cmd/pkgsite@latest
$ cd myproject
$ pkgsite -open .
```
For more information, see the [pkgsite documentation](https://pkg.go.dev/golang.org/x/pkgsite/cmd/pkgsite).
## Issues
If you want to report a bug or have a feature suggestion, please first check
the [known issues](https://github.com/golang/go/labels/pkgsite) to see if your
issue is already being discussed. If an issue does not already exist, feel free
to [file an issue](https://golang.org/s/pkgsite-feedback).
For answers to frequently asked questions, see [pkg.go.dev/about](https://pkg.go.dev/about).
You can also chat with us on the
[#pkgsite Slack channel](https://gophers.slack.com/archives/C0166L4QGJV) on the
[Gophers Slack](https://invite.slack.golangbridge.org).
## Contributing
We would love your help!
Our canonical Git repository is located at
[go.googlesource.com/pkgsite](https://go.googlesource.com/pkgsite).
There is a mirror of the repository at
[github.com/golang/pkgsite](https://github.com/golang/pkgsite).
To contribute, please read our [contributing guide](CONTRIBUTING.md).
## License
Unless otherwise noted, the Go source files are distributed under the BSD-style
license found in the [LICENSE](LICENSE) file.
## Links
- [Homepage](https://pkg.go.dev)
- [Feedback](https://golang.org/s/pkgsite-feedback)
- [Issue Tracker](https://golang.org/s/pkgsite-issues)