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

feat(docs): wpis urzadzenia moze wskazac swoj szczegolowy poradnik - #260

Merged
msgwing merged 1 commit into
mainfrom
device-guide-link
Aug 23, 2026
Merged

msgwing merged 1 commit into
mainfrom
device-guide-link

Conversation

@msgwing

@msgwing msgwing commented Aug 23, 2026

Copy link
Copy Markdown
Owner

HP ma teraz dwie strony: generowany wpis kompatybilności — wiersz faktów z oświadczeniem producenta za nim — oraz HP-PRINTER-SMTP.md, która tłumaczy, co znaczy „SMTP server requires authentication" i co zrobić z każdą z jej trzech przyczyn.

Nic ich nie łączyło. Czytelnik, który znalazł wiersz kompatybilności, dostawał status i żadnej drogi dalej.

Generator renderuje ten link wyłącznie tam, gdzie wpis go nazywa. Ten warunek ma znaczenie: linijka „dalsza lektura" wskazująca stronę o dziesięciu markach nie jest dalszą lekturą — to ten sam link, który sekcja Related już niesie.

Dlaczego jeden link, a nie trzydzieści cztery

Kuszące było dorzucenie nowych stron do sekcji Related na każdej generowanej stronie. Trzy linki wchodzące stają się trzydziestoma czterema i liczby wyglądają lepiej.

Czytelnik strony o 5.7.233 — dzienny limit wysyłki tenanta — nie zyskuje nic z linku do poradnika o drukarkach HP.

Linkowanie wewnętrzne pomaga wtedy, gdy jest tym linkiem, którego ktoś chciał następnie.

HP now has two pages: the generated compatibility entry, which is a row of
facts with the vendor's statement behind it, and HP-PRINTER-SMTP.md, which
explains what "SMTP server requires authentication" means and what to do about
each of its three causes. Nothing connected them, so a reader who found the
compatibility row got the status and no way forward.

The generator renders the link only where an entry names one. That condition
matters: a "further reading" line pointing at a page covering ten brands is not
further reading, it is the same link the Related section already carries, and
adding it everywhere would be link-stuffing our own site rather than helping
anybody.

Which is also why this is one link and not thirty-four. The tempting version
was to add the new focused pages to the Related section on every generated
page - three inbound links each becomes thirty-four, and the numbers look
better. A reader on the page for 5.7.233, a tenant daily sending limit, gains
nothing from a link to an HP printer guide. Internal links help when they are
the link somebody wanted next.
@msgwing
msgwing enabled auto-merge August 23, 2026 11:31
@github-actions github-actions Bot added the docs label Aug 23, 2026
@msgwing
msgwing merged commit 2acf8c8 into main Aug 23, 2026
36 checks passed
@msgwing
msgwing deleted the device-guide-link branch August 23, 2026 11:32
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