Repository navigation
UX: Make "Edit" button more discoverable #9541
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:
Activity
ntrogh commentedon Mar 11, 2026
Karl Horky (@karlhorky) Great suggestions. For context, we're aligning with the GitHub docs for consistency. I realize that our inline link might not be discoverable enough. Would using an actual button be more helpful?
karlhorky commentedon Mar 11, 2026
Changing the link to a button would already be a good start 👍 Not sure I would call this issue resolved with this change, but it would at least help.
Two more things that would be nice to see before closing the issue: