UX: Make "Edit" button more discoverable

Maintainers usually reply within 1 day

Assessment

This issue has not been assessed yet.

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:

Getting set up

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.

More from microsoft/vscode-docs

• Clarify EU data residency and DPA scope for Claude harness with Copilot authentication

  Open

  ⋯Report a problem with this issue

  • Is something wrong?

  • Already taken
  • Not beginner-friendly
  • Stale or invalid
  • Something else…
  • Send Cancel
  triage-needed

  Difficulty 2/5 1-3 hours Newbie friendliness 70/100

  microsoft/vscode-docs#10626 · Opened Nov 10, 2026

  Maintainers usually reply within 1 day

• Agent plugin migration: gaps in package conversion, canvas discovery, and hook stdout guidance

  Possibly taken @jebakishore509-sys claimed this 12 days ago. Open

  ⋯Report a problem with this issue

  • Is something wrong?

  • Already taken
  • Not beginner-friendly
  • Stale or invalid
  • Something else…
  • Send Cancel

  Difficulty 4/5 3-5 days Newbie friendliness 54/100

  microsoft/vscode-docs#10551 · Opened Oct 27, 2026

  Maintainers usually reply within 1 day

• Temporary workaround: publish VS Code extensions with an organization-scoped PAT

  Open

  ⋯Report a problem with this issue

  • Is something wrong?

  • Already taken
  • Not beginner-friendly
  • Stale or invalid
  • Something else…
  • Send Cancel
  doc-enhancement

  Difficulty 1/5 Under an hour Newbie friendliness 45/100

  microsoft/vscode-docs#10526 · 1 reaction · Opened Oct 21, 2026

  Maintainers usually reply within 1 day

• Ensure the contrast between foreground and background colors meets WCAG 2 AA minimum contrast ratio thresholds (span:nth-child(6)):A11y_code.visualstudio.com_AI4W

  May be free again @ntrogh claimed this 38 days ago, and no pull request is open. Open

  ⋯Report a problem with this issue

  • Is something wrong?

  • Already taken
  • Not beginner-friendly
  • Stale or invalid
  • Something else…
  • Send Cancel

  microsoft/vscode-docs#10424 · 1 comment · 1 assignee · Opened Oct 5, 2026

  Maintainers usually reply within 1 day

• How VS Code team uses AI

  Open

  ⋯Report a problem with this issue

  • Is something wrong?

  • Already taken
  • Not beginner-friendly
  • Stale or invalid
  • Something else…
  • Send Cancel
  idea

  Difficulty 3/5 1-2 days Newbie friendliness 45/100

  microsoft/vscode-docs#10216 · 1 comment · Opened Sep 1, 2026

  Maintainers usually reply within 1 day

All issues in microsoft/vscode-docs