Broken images in Python Tutorial and FastAPI Tutorial after Python Environments refactor

Aperta
  • Qualcosa non va?
#10,553 0 commenti 0 reazioni 0 assegnatari Vedi su GitHub

I maintainer di solito rispondono entro 1 giorno

@alok-108 ci sta già lavorando.

Dal 28/10/2026.

  • #10558 di @alok-108 — aperta

Valutazione

Difficoltà
2/5
Tempo stimato
1-3 ore
Idoneità per principianti
25/100
Tipo di issue
Documentazione
Chiarezza
Specificata chiaramente
Stato di attività
Ferma
Stack tecnologico
markdown
Ambito
documentation

Direzione di ricerca

Read docs/python/python-tutorial.md and docs/python/tutorial-fastapi.md, then inspect the current images in docs/python/images/environments/ and compare them with the environment creation steps in both tutorials. Update the outdated image references and walkthrough to match the current workflow; done means the referenced images exist and the screenshots accurately illustrate the steps.

Scritto dal modello di indicizzazione a partire dal testo della issue.

Descrizione

triage-needed
Summary

In the official Python tutorial (docs/python/python-tutorial.md) and the FastAPI tutorial (docs/python/tutorial-fastapi.md), several environment creation screenshots are broken and returning 404 on the live website code.visualstudio.com/docs/python/python-tutorial.

Cause

In commit 938e7e2b0 (#9364 - "docs: update Python environments documentation for release of Python Envs Ext as default"), several legacy environment image files were removed from docs/python/images/environments/:

  • create_environment_dropdown.png
  • interpreters-list.png
  • create_environment_prompt_status.png

However, references to these deleted images remain in:

  1. docs/python/python-tutorial.md:
    • Line 105: ![Create Environment dropdown](images/environments/create_environment_dropdown.png)
    • Line 111: ![Virtual environment interpreter selection](images/environments/interpreters-list.png)
    • Line 117: ![Create environment status notification](images/environments/create_environment_prompt_status.png)
  2. docs/python/tutorial-fastapi.md:
    • Line 76: ![Dropdown with "Venv" or "Conda" as options for environments that can be created with the Python: Create Environment command](images/environments/create_environment_dropdown.png)
Screenshot (from live documentation page)

Broken images on Python Tutorial

Live HTTP verification:

$ curl -I https://code.visualstudio.com/assets/docs/python/environments/create_environment_dropdown.png
HTTP/1.1 404 The requested content does not exist.
Proposed Fix

Update docs/python/python-tutorial.md and docs/python/tutorial-fastapi.md to align the walkthrough and images with the modern Python environment creation workflow (referencing the current images in docs/python/images/environments/, such as quickCreate.png and selectedInterpreter.png).

I would be glad to submit a PR to resolve this!

Lingua principale
Markdown
Stelle
6.7k
Fork
5.8k
Merge medio
18h 28m
PR unite (30g)
108

Preparare l'ambiente

Apri in Codespaces

Avvia il container di sviluppo del progetto nel browser, con il tuo account GitHub.

Come iniziare

  1. Leggi tutta la issue e poi la guida ai contributi del progetto.
  2. Commenta sulla issue per dire che te ne occupi tu — evita che due persone facciano lo stesso lavoro.
  3. Fai un fork del repository e lavora su un branch.
  4. Apri una pull request che faccia riferimento al numero della issue.

Altre issue di microsoft/vscode-docs

Tutte le issue di microsoft/vscode-docs

Issue simili

Altre issue su Documentation

Ricevi le nuove issue nella tua casella

Un breve riepilogo di issue GitHub adatte ai principianti.