Bring the plugins README and a style comment to All locations and fetch terms on every big board

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
This commit is contained in:
WolfandClaude Opus 5.5 committed 2026-10-04 21:43:01 +02:00
1 parent 1f444aa077
commit d80f26a930
2 files changed
+3 -3

No files matched your search

+1 -1
View File
@@ -1212,7 +1212,7 @@ table.applications td[data-label="Saved"] { white-space: nowrap; color: var(--di
.affinity button[data-value="-1"][aria-pressed="true"] {
color: var(--accent-fg); background: var(--error); border-color: var(--error);
}
/* The two fetch overrides, All countries and All roles, global and apart
/* The two fetch overrides, All locations and All roles, global and apart
from the stances: green, the colour the app gives what widens (`--good`). */
.affinity button[data-value="countries"][aria-pressed="true"],
.affinity button[data-value="roles"][aria-pressed="true"] {
+2 -2
View File
@@ -110,9 +110,9 @@ Numbers are from the live database on 2026-09-30, after the pull of 12:52. "Open
| robots.txt | not read at run time | Decided per reader when it is built and recorded in `READS.robots` with the date (`docs/decisions.md`). `Crawl-delay` is not honoured. |
| 429 | first page: the board fails; a later page: the read stops, keeps what it read and is incomplete; a role page: the reads of that board stop until the next fetch text run | Nothing is closed on a list cut short by a 429. |
How far a board is read: a pull asks each board of 300 roles or more for the reach of the search agents that are switched on (`app/jobs/reach.py`): the union of their `any` gates on country, town (as its country) and remote, or every role when one agent can take a role from anywhere. A company set to All countries is asked for the agents' wide reach, the union of their `require` reach, Europe today; a host that asks one country a request reads such a board whole instead of once per country (33 codes today), unless fetch terms narrow it. A board's own reach, set on the Companies list, wins. A complete filtered read closes the roles outside the reach, except those with a vote or an application. A board's size is set once, when it is added, on Recheck or by `app companies size`, and a pull does not rewrite it; a board with no size yet is sized first in its batch and then read as its size says, and a board whose reader cannot narrow the reach is read whole and sized by that read. A host that cannot filter a dimension ignores it: SmartRecruiters, Phenom, SuccessFactors and Eightfold have no remote filter, so their reach asks for countries only.
How far a board is read: a pull asks each board of 300 roles or more for the reach of the search agents that are switched on (`app/jobs/reach.py`): the union of their `any` gates on country, town (as its country) and remote, or every role when one agent can take a role from anywhere. A company set to All locations is asked for the agents' wide reach, the union of their `require` reach, Europe today; a host that asks one country a request reads such a board whole instead of once per country (33 codes today), unless fetch terms narrow it. A board's own reach, set on the Companies list, wins. A complete filtered read closes the roles outside the reach, except those with a vote or an application. A board's size is set once, when it is added, on Recheck or by `app companies size`, and a pull does not rewrite it; a board with no size yet is sized first in its batch and then read as its size says, and a board whose reader cannot narrow the reach is read whole and sized by that read. A host that cannot filter a dimension ignores it: SmartRecruiters, Phenom, SuccessFactors and Eightfold have no remote filter, so their reach asks for countries only.
Fetch terms narrow a wide read by words. Each agent has a list of them (`fetch_terms`, set in the agent editor); the terms of a pull are the union over the agents that are on, and none when one of those agents has none. They go only to a board read with the wide reach: a company set to All countries, or a board whose reach is more countries than a one-country host is asked for (`MAX_SERIES`, 8). The narrow reach (Denmark, Sweden) leaves at most about 150 roles on any big board, so it takes no terms, and nor does a board under 300 roles or one with its own reach. A company set to All roles takes none on any of its boards. A host that takes a keyword gets one series per term, unioned by id, each combined with the country series; the survey shows that as an AND on SmartRecruiters, Eightfold, SuccessFactors, Phenom and Workday. When terms times the country series exceed 8, the place part of the reach goes first, whole, and the terms stay; more than 8 terms read the board unfiltered. The survey found the keyword matching the ad text and not only the title where it could tell, and could not tell on SuccessFactors, Workday, Workable and Jibe (`docs/filter-survey.md`), so a term like `engineer` cuts less than it looks. A read with terms is never the whole board: it records no size, closes no role it did not list, and the 10% guard holds it only to a read with the same terms and places. The search providers take no terms: each saved search has its own query.
Fetch terms narrow a big board's read by words. Each agent has a list of them (`fetch_terms`, set in the agent editor); the terms of a pull are the union over the agents that are on, and none when one of those agents has none. They go to every board of 300 roles or more, on the narrow and the wide reach alike; a board under 300 roles, one with its own reach and every board of a company set to All roles take none. A host that takes a keyword gets one series per term, unioned by id, each combined with the country series; the survey shows that as an AND on SmartRecruiters, Eightfold, SuccessFactors, Phenom and Workday. When terms times the country series exceed 8, a wide read drops the place part of the reach, whole, and keeps the terms, while a narrow read keeps the places and drops the terms; more than 8 terms read the board unfiltered. The survey found the keyword matching the ad text and not only the title where it could tell, and could not tell on SuccessFactors, Workday, Workable and Jibe (`docs/filter-survey.md`), so a term like `engineer` cuts less than it looks. A read with terms is never the whole board: it records no size, closes no role it did not list, and the 10% guard holds it only to a read with the same terms and places. The search providers take no terms: each saved search has its own query.
What no source does: