Conversation
…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.
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.
Ludzie coraz częściej pytają asystenta zamiast wyszukiwarki. Administrator pyta, co się psuje w grudniu. Serwisant pyta, co znaczy
1102na 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.txtto 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: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:
robots.txtjuż przepuszczał wszystkie roboty, w tym te od AI — teraz mówi to celowo, a nie domyślnie.