1
0
mirror of https://github.com/golang/go synced 2024-09-30 16:28:32 -06:00
go/gopls
Rob Findley 9497f49d57 gopls/integration: cosmetic/ergonomic updates
Some ergonomic and cosmetic updates are made to the integration/replay
and integration/parse packages, following a pass through the code:
 + In the README, a some typos are corrected.
 + A few symbols are renamed:
   - Direction->MsgType, since this type is more than a client-server
     direction
   - logRec->scanLogs, to be more consistent with the naming convention
     SplitFuncs in the bufio package
   - CamelCase is applied in a few places.
 + Context is plumbed through, rather than use a package local ctx.
 + In a few cases, returning an error is preferred over log.Fatal.
 + Some duplicated code is deleted, and types from the parse package are
   reused. (this was probably cruft from the repo migration)
 + The logfile is made an argument rather than a flag to the replay
   tool.

Change-Id: Ie72e6e8a4d7020d8cf708f6791353897791bcc86
Reviewed-on: https://go-review.googlesource.com/c/tools/+/211057
Reviewed-by: Peter Weinberger <pjw@google.com>
2020-01-02 14:09:08 +00:00
..
doc all: remove many cases of space-space 2019-12-30 19:07:42 +00:00
integration gopls/integration: cosmetic/ergonomic updates 2020-01-02 14:09:08 +00:00
internal/hooks gopls: use mvdan.cc/xurls for textDocument/documentLink 2019-12-26 21:20:25 +00:00
test gopls: control features for command line tests 2019-11-07 01:09:34 +00:00
go.mod gopls: use mvdan.cc/xurls for textDocument/documentLink 2019-12-26 21:20:25 +00:00
go.sum gopls: use mvdan.cc/xurls for textDocument/documentLink 2019-12-26 21:20:25 +00:00
main.go internal/lsp: use options hooks to install diff driver 2019-10-11 16:38:31 +00:00
README.md fix: using section links to IDE specific doc 2019-12-17 14:12:49 +00:00

gopls documentation

gopls (pronounced: "go please") is the official language server for the Go language.

Status

It is currently in alpha, so it is not stable.

You can see more information about the status of gopls and its supported features here.

Roadmap

The current goal is a fully stable build with the existing feature set, aiming for the first half of 2020, with release candidates earlier in the year.

This will be the first build that we recommend people use, and will be tagged as the 1.0 version. You can see the set of things being worked on in the 1.0 milestone, in general we are focused on stability, specifically, making sure we have a reliable service that produces an experience in module mode that is not a retrograde step from the old tools in GOPATH mode.

There is also considerable effort being put into testing in order to make sure that we both have a stable service and also that we do not regress after launch.

While we may continue to accept contributions for new features, they may be turned off behind a configuration flag if they are not yet stable. See the gopls unplanned milestone for deprioritized features.

This is just a milestone for gopls itself. We work with editor integrators to make sure they can use the latest builds of gopls, and will help them use the 1.0 version as soon as it is ready, but that does not imply anything about the stability, supported features or version of the plugins.

Using

In general you should not need to know anything about gopls, it should be integrated into your editor for you.

To install for your specific editor you can follow the following instructions

See the user guide for more information, including the how to install gopls by hand if you need.

Issues

If you are having issues with gopls, please first check the known issues before following the troubleshooting guide. If that does not give you the information you need, reach out to us.

You can chat with us on:

If you think you have an issue that needs fixing, or a feature suggestion, then please make sure you follow the steps to file an issue with the right information to allow us to address it.

If you need to talk to us directly (for instance to file an issue with confidential information in it) you can reach out directly to @stamblerre or @ianthehat.

More information

If you want to know more about it, have an unusual use case, or want to contribute, please read the following documents