microsoft / microsoft/vscode-docs

UX: Make "Edit" button more discoverable

Open
#9,541 2 comments 1 reaction 1 assignee View on GitHub

@ntrogh is already working on this.

Since Mar 11, 2026.

docs-experience feature-request
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:

Image

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:

Image Image

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:

Image

Contributor guide

Open the contributing guide

First steps

  1. Read the whole issue, then the project's contributing guide.
  2. Comment on the issue to say you are picking it up — it saves two people doing the same work.
  3. Fork the repository and make your change on a branch.
  4. Open a pull request that references the issue number.

Assessment

This issue has not been assessed yet.

Get new issues in your inbox

A short digest of beginner-friendly GitHub issues.