Hacktoberfest 2026: le issue che i maintainer hanno segnato per ottobre, aperte e adatte ai principianti. Sfoglia le issue Hacktoberfest

Compatibility with old `#` fragments

Aperta
#2,338 0 commenti 1 reazione 0 assegnatari Vedi su GitHub

I maintainer di solito rispondono entro 1 giorno

Nessuno ha ancora preso questa issue.

Valutazione

Difficoltà
4/5
Tempo stimato
3-5 giorni
Idoneità per principianti
45/100
Tipo di issue
Funzionalità
Chiarezza
Abbastanza chiara
Stato di attività
Tranquilla
Stack tecnologico
express, javascript, nodejs

Direzione di ricerca

Inizia esaminando l’issue #2324 e i reindirizzamenti attuali dai vecchi URL dell’API alle pagine di panoramica dell’API. Traccia il modo in cui vengono gestiti i frammenti come #res.send, quindi scegli e documenta un approccio per mappare i vecchi frammenti alle pagine dell’API corrispondenti, preservando il frammento. Il lavoro è completato quando i vecchi link dell’API raggiungono la sezione appropriata, includendo i frammenti delle guide se rientrano nell’ambito.

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

Descrizione

design discuss enhancement

In #2324 I'm fixing the URLs in our docs to point to appropriate sections in the docs. Other external resources (StackOverflow, GitHub comments, other websites) won't be updated and the links won't point them where they should.

While we could add elements with ids matching the old ones just like Node.js does (https://github.com/nodejs/doc-kit/issues/697), this would not solve the problem. Old links look like /en/4x/api.html#res.send, but on the new website a link to the same section would be /en/5x/api/response/#ressendbody. The old URL (after 301 redirect) leads to the API overview page.

Fixing this would require (besides adding elements with matching ids):

  • going back to (or just adding) a single unified page with all API docs, or
  • adding a client-side script to the API overview pages that parses the fragment and based on the element before . redirects to express (#express*), application (#app*), request (#req*), response (#res*) or router (#router*) while keeping the fragment.

Fragment in guides also don't point to the same sections, but this is much less important and making it compatible with old URLs would not require any redirects or other complicated things (just hidden elements with old ids).

Lingua principale
MDX
Stelle
5.4k
Fork
2.3k
Merge medio
2g 6h
PR unite (30g)
24

Preparare l'ambiente

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 expressjs/expressjs.com

Tutte le issue di expressjs/expressjs.com

Issue simili

Altre issue su Documentation

Ricevi le nuove issue nella tua casella

Un breve riepilogo di issue GitHub adatte ai principianti.