Sitelet https://github.com/msgwing/ZeroSMTP/pull/247
Skip to content

docs: narzedzie na stronie, przez ktora wchodzi caly serwis - #247

Merged
msgwing merged 1 commit into
mainfrom
index-tool
Aug 23, 2026
Merged

msgwing merged 1 commit into
mainfrom
index-tool

Conversation

@msgwing

@msgwing msgwing commented Aug 23, 2026

Copy link
Copy Markdown
Owner

Sprawdzone, nie założone — i wynik gorszy, niż się spodziewałem:

Na stronie głównej docs
wzmianek o zerosmtp-check 0
wzmianek o npx 0
linków do 17 stron pod konkretne błędy 0

To punkt wejścia całego serwisu i nie wiedział nic o dwóch dniach pracy.

Ta sama wada co sieroty i README dziś rano, w trzecim miejscu: rzecz zostaje zbudowana i nie pojawia się tam, gdzie ludzie lądują.

Nad tabelą, nie jako jej siedemnasty wiersz

Tabela odpowiada na pytanie „której strony potrzebuję" — słuszne, gdy ktoś czyta. Ktoś w trakcie awarii, z błędem na ekranie, ma inne pytanie, i dla niego jedna komenda bije wybór z szesnastu opcji. Zwłaszcza że tekst, na który patrzy, zwykle nie jest tym, co wysłał serwer — a tego żadna strona nie powie mu przez dobrą organizację.

Przypadek zawieszania nazwany osobno, bo to najczęstsza pierwsza awaria i w ogóle nie jest problemem uwierzytelniania: sieć odrzuca port, a żadna ilość czytania o 5.7.139 tego nie powie.

Checked rather than assumed, and the result was worse than expected: the docs
homepage mentioned zerosmtp-check zero times, npx zero times, and linked to none
of the seventeen per-error pages. It is the entry point for the site and it knew
nothing about two days of work.

Same failure as the orphan pages and the README earlier today, in a third place:
the thing gets built and does not appear where people land.

It goes above the triage table rather than becoming a seventeenth row in it. The
table answers "which page do I need", which is the right question when you are
reading. Somebody mid-incident with an error on screen has a different one, and
for them a single command beats picking from sixteen options - especially since
the string they are looking at is usually not what the server sent, which is the
part no page can tell them by being well organised.

The hanging case is named separately because it is the most common first
failure and it is not an authentication problem at all: the network is refusing
the port, and no amount of reading about 5.7.139 will say so.
@msgwing
msgwing enabled auto-merge August 23, 2026 10:35
@github-actions github-actions Bot added the docs label Aug 23, 2026
@msgwing
msgwing merged commit d9742a6 into main Aug 23, 2026
34 checks passed
@msgwing
msgwing deleted the index-tool branch August 23, 2026 10:35
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant