search

microsoft / vscode

Visual Studio Code
https://code.visualstudio.com
MIT License
164k stars 29.2k forks source link

Broken link in wiki for working areas #225258

Open ravicodelabs opened 2 months ago

ravicodelabs commented 2 months ago

The "working areas" link in the issue tracking wiki is broken:

https://github.com/microsoft/vscode-internalbacklog/blob/main/assignments/working-areas.md

gjsjohnmurray commented 2 months ago

This is a link to a MS-internal document.

ravicodelabs commented 2 months ago

OK I see. I arrived it at the document as follows:

1) Created an issue 2) Clicked to submit a bug 3) Followed suggestion to read - https://github.com/microsoft/vscode/wiki/Submitting-Bugs-and-Suggestions 4) Followed link at bottom to "issue tracking" - https://github.com/Microsoft/vscode/wiki/Issue-Tracking 5) Clicked "working areas" which led to the 404 page.

...so perhaps it would make sense to remove that link from a publicly accessible doc, or direct the user to a page which says this is an internal document perhaps, or similar. Currently it brings up a 404 page, which seems confusing when one is trying to follow the steps for filing a new issue.

Thanks for the info!

gjsjohnmurray commented 2 months ago

The "Issue Tracking" page begins:

This page describes how we track issues in the vscode repository.

It's not clear, but "we" refers to the VS Code team at Microsoft.

ravicodelabs commented 2 months ago

Right yes, that is the issue, since it is an open-source project the "we" can be interpreted as including external devs. So maybe "we" can be changed to "the internal team" or "the internal Microsoft team" perhaps. Though it would be nice if in addition, clicking the link did not show a 404, and instead showed something more helpful.