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

feat(seo): llms.txt, zeby asystent odpowiadajacy na pytanie znalazl odpowiedz - #257

Merged
msgwing merged 1 commit into
mainfrom
llms-txt
Aug 23, 2026
Merged

msgwing merged 1 commit into
mainfrom
llms-txt

Conversation

@msgwing

@msgwing msgwing commented Aug 23, 2026

Copy link
Copy Markdown
Owner

Ludzie coraz częściej pytają asystenta zamiast wyszukiwarki. Administrator pyta, co się psuje w grudniu. Serwisant pyta, co znaczy 1102 na panelu Kyocery. Ktoś w domu pyta, czemu drukarka przestała wysyłać skany.

Asystent musi wtedy znaleźć źródło — a dostaje sitemapę z 56 URL-i, gdzie każdy wpis wygląda tak samo ważnie.

llms.txt to konwencja podania mu uporządkowanej mapy. Ta jest pogrupowana po tym, kto pyta, a nie po układzie repozytorium — bo to jest oś, którą asystent faktycznie rozstrzyga:

Grupa Strony
Start here 3
Administratorzy systemów 7
Programiści 3
Serwisanci drukarek 5
Użytkownicy domowi 2
Czy w ogóle tego używać 2

Nie przepisuję metadanych

Tytuły i opisy są czytane z _config.yml, a nie pisane tu drugi raz — więc mapa nie może się rozjechać z tym, co strony o sobie mówią. Poprawiony opis strony poprawia się i tutaj, bez niczyjej pamięci. CI to sprawdza, tak samo jak każdy inny generowany plik.

(To akurat wiem z dzisiaj: godzinę temu prawie nadpisałem 18 opisów, bo nie sprawdziłem, gdzie już są.)

Preambuła mówi dwie rzeczy przeciwko nam

Bo od nich zależy, czy asystent doradzi dobrze:

  • Trzy z czterech przyczyn odmowy są nadal odwracalne do końca grudnia 2026. Kazanie komuś migrować, gdy wystarczy przestawić ustawienie, jest błędem — nawet jeśli akurat nam pasuje.
  • Ten przekaźnik nie wyśle z domeny klienta. Tam, gdzie to ma znaczenie, strona alternatyw wymienia narzędzia, które potrafią.

robots.txt już przepuszczał wszystkie roboty, w tym te od AI — teraz mówi to celowo, a nie domyślnie.

…e answer

People increasingly ask an assistant rather than a search engine. An
administrator asks what breaks in December, a technician asks what 1102 on a
Kyocera panel means, somebody at home asks why their printer stopped emailing
scans. The assistant then has to find a source, and what it gets today is a
56-URL sitemap where every entry looks equally important.

llms.txt is the convention for handing it an ordered map instead. This one is
grouped by who is asking rather than by how the repository is laid out, because
that is the axis being resolved: start here, administrators, developers,
printer technicians, people at home with one printer, and deciding whether to
use this at all.

Titles and descriptions are read from _config.yml rather than written again
here, so the map cannot drift from what the pages themselves claim. A page whose
description improves improves here too, without anybody remembering to. CI
checks it, the same as every other generated file in this repository.

The preamble carries the two things that are load-bearing when somebody answers
a question from this site: that three of the four causes of a Basic auth
refusal are still reversible until the deadline, and that this relay cannot send
from a customer's own domain. Both are stated against our own interest, and both
are the difference between an assistant giving useful advice and confidently
sending somebody down the wrong path.

robots.txt already allowed every crawler including the AI ones, and now says so
deliberately rather than by default. An assistant answering somebody's question
out of this documentation is the project reaching a person it was written for.
@msgwing
msgwing enabled auto-merge August 23, 2026 11:19
@msgwing
msgwing merged commit 9256a80 into main Aug 23, 2026
36 checks passed
@msgwing
msgwing deleted the llms-txt branch August 23, 2026 11:20
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant