feat(docs): wpis urzadzenia moze wskazac swoj szczegolowy poradnik - #260
Merged
Merged
Conversation
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.
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
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
Relatedjuż niesie.Dlaczego jeden link, a nie trzydzieści cztery
Kuszące było dorzucenie nowych stron do sekcji
Relatedna 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.