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

docs: write docs/testing.md covering the test projects and the headless render harness

Aperta Adatta ai principianti
  • Qualcosa non va?
#349 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à
2/5
Tempo stimato
1-3 ore
Idoneità per principianti
88/100
Tipo di issue
Documentazione
Chiarezza
Specificata chiaramente
Stato di attività
Attiva
Stack tecnologico
csharp
Ambito
documentation

Direzione di ricerca

Inizia da CONTRIBUTING.md, Makefile:49, tests/LageBuch.Acceptance.Tests/TestAppBuilder.cs e BitmapSaveExtensions.cs; esamina gli otto progetti sotto tests/ e i relativi assembly sotto src/. Esegui ogni comando documentato, incluso l’esempio circoscritto di make test ed entrambi i target di test. Il lavoro è completo quando docs/testing.md spiega la struttura del progetto, il filtraggio, il rendering headless, l’ispezione dei PNG e la suddivisione di xunit, con un link dalla sezione di compilazione e test di CONTRIBUTING.md.

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

Descrizione

documentation good first issue

CONTRIBUTING.md tells you to run dotnet test and stops there. The repo
actually has eight test projects, a Makefile front end for narrowing a run, and
a headless Skia harness that renders real Avalonia views to bitmaps. None of
that is written down.

What to do

Write docs/testing.md covering:

  • The eight projects under tests/, one per src/ assembly, and what kind
    of test belongs in each.
  • Narrowing a run. make test PROJECT=tests/LageBuch.Domain.Tests FILTER=Name~Formatting.
    Explain why PROJECT is needed when filtering: a bare FILTER fails in
    assemblies that match nothing. The comment at Makefile:49 says so.
  • make test versus make test-all — the first uses the solution filter
    without the Android head, so it works on machines whose JDK is too new.
  • The headless render harness at tests/LageBuch.Acceptance.Tests/TestAppBuilder.cs.
    Explain UseHeadlessDrawing = false: it keeps the real Skia backend so
    embedded custom fonts rasterize, and the default headless stub throws on first
    text layout instead. The comment in that file explains it.
  • Eyeballing render output with the PNG helpers in BitmapSaveExtensions.cs.
  • The xunit version split — LageBuch.Acceptance.Tests is on xunit.v3, the
    others on v2.

Add a link to the new page from the build-and-test section of CONTRIBUTING.md.

Verify

Run every command you put in the document and confirm the output matches what
you wrote.

Difficulty: easy. A good issue if you would rather read a codebase than
change one.

New here?

Comment to claim this issue and it is yours. If no pull request appears within
seven days it goes back in the pool, no hard feelings.

Before you open the PR, please skim CONTRIBUTING.md:
commits need DCO sign-off (git commit -s) and a Conventional Commit subject.
Changes under src/ additionally need an entry under ## [Unreleased] in
CHANGELOG.md — CI fails the PR otherwise.

Questions are welcome right here or in
Discussions.

Lingua principale
C#
Stelle
1
Fork
3
Merge medio
4h 49m
PR unite (30g)
177

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 CodeForFire/lagebuch

Tutte le issue di CodeForFire/lagebuch

Issue simili

Altre issue su C#

Ricevi le nuove issue nella tua casella

Un breve riepilogo di issue GitHub adatte ai principianti.