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

Add a browser-level layout test for the API examples column

Aperta
#4,555 0 commenti 0 reazioni 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
55/100
Tipo di issue
Funzionalità
Chiarezza
Specificata chiaramente
Stato di attività
Attiva
Stack tecnologico
csharp, playwright
Ambito
testing

Direzione di ricerca

Start by reading the existing visual harness in src/Elastic.Documentation.Site/visual/ and the test setup behind npm run test; those tests use JSDOM and cannot measure layout. Add a Playwright test that loads a fixed local API spec with long request and response examples in both layouts at short and tall window heights. Done means both code blocks keep nonzero, stable heights and the response can be reached by scrolling.

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

Descrizione

enhancement needs triage user-experience

The API examples column has no automated test that checks its layout, so a window-height bug like the one fixed in #4554 can come back with every check green.

What is getting in your way

npm run test runs in JSDOM, which does no layout. It cannot see a request code block that collapses to zero height or a response pushed out of view. The visual harness in src/Elastic.Documentation.Site/visual/ compares screenshots against seeded baselines. It does not assert block heights or reachability, and the API pages it loads build from specs fetched at run time.

What would you like instead

A Playwright test that opens an API operation with a long request example and a long response example. It runs at a short and a tall window height, in the legacy and the design-system layouts. It asserts that each code block has a nonzero height that stays the same across window heights, and that the response is reachable by scrolling the page. The operation needs a fixed local spec, so the example lengths do not change between runs.

Anything else

Raised in review on #4554 by an automated reviewer.

Lingua principale
C#
Stelle
25
Fork
45
Merge medio
17h 9m
PR unite (30g)
292

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 elastic/docs-builder

Tutte le issue di elastic/docs-builder

Issue simili

Altre issue su C#

Ricevi le nuove issue nella tua casella

Un breve riepilogo di issue GitHub adatte ai principianti.