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/tools/gopls: add a mechanism for marking a setting deprecated in documentation #42107

Open
stamblerre opened this issue Oct 21, 2020 · 0 comments
Open

Comments

@stamblerre
Copy link
Contributor

@stamblerre stamblerre commented Oct 21, 2020

We currently have a way of notifying users that they are using a deprecated setting, but it would also be nice to mark the deprecation in the documentation. This way, we could surface the deprecation in the package.json and smoothly transition users off of an outdated setting.

/cc @heschik @hyangah

Edit: This would be doable by adding a struct tag that sets a field's status to "deprecated". We could then use reflection to check the field's status when setting it. However, we should probably only do this once we set all options using reflection, which is a big enough change that we shouldn't do it until after February.

@stamblerre stamblerre added this to the gopls/v1.0.0 milestone Oct 21, 2020
@stamblerre stamblerre added this to Needs Triage in vscode-go: gopls by default Nov 10, 2020
@stamblerre stamblerre moved this from Needs Triage to Non-critical in vscode-go: gopls by default Nov 10, 2020
@stamblerre stamblerre moved this from Non-critical to Documentation in vscode-go: gopls by default Nov 10, 2020
@stamblerre stamblerre removed this from Documentation in vscode-go: gopls by default Dec 26, 2020
@stamblerre stamblerre added this to To Do in gopls: v1.0.0 Feb 28, 2021
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Projects
Linked pull requests

Successfully merging a pull request may close this issue.

None yet
2 participants