microsoft / microsoft/vscode-docs
UX: Make "Edit" button more discoverable
@ntrogh is already working on this.
Since Mar 11, 2026.
- Dominant language
- Markdown
- Stars
- 6.6k
- Forks
- 5.8k
- Avg merge
- 11h 43m
- Merged PRs (30d)
- 123
Description
Hi, first of all, as usual thanks for all of your hard work on VS Code, the docs and the wider ecosystem. It's amazing to have these advanced tools available for free, especially for beginners like our students at https://upleveled.io
Looking at the docs pages, I was missing an easy way to contribute. I eventually found it, but I think it could be more discoverable.
For example, on https://code.visualstudio.com/docs/configure/custom-layout, I see the very small link text buried in a paragraph down at the bottom:
Compare this to the Expo docs (eg. https://docs.expo.dev/more/create-expo/), which has 2 Edit buttons - one at the top and one at the bottom of the page:
Or possibly even better: the Next.js docs (eg. https://nextjs.org/docs/app/api-reference/config/next-config-js/logging) have the edit button in the sticky right sidebar, which means that at any point of scrolling, there is an edit link visible on the page:
Contributor guide
First steps
- Read the whole issue, then the project's contributing guide.
- Comment on the issue to say you are picking it up — it saves two people doing the same work.
- Fork the repository and make your change on a branch.
- Open a pull request that references the issue number.
Assessment
This issue has not been assessed yet.