Describe every source in plugins/README.md: how it is read, what it delivers and its limits

Co-Authored-By: Claude Fable 5.1 <noreply@anthropic.com>
This commit is contained in:
WolfandClaude Fable 5.1 committed 2026-09-29 22:23:43 +02:00
1 parent 31abad4c8e
commit 30b36df2fb
2 files changed
+508

No files matched your search

+3
View File
@@ -18,4 +18,7 @@ What is left after the phone rework of 2026-09-25, for whoever picks the repo up
- **A SuccessFactors site on a company's own domain is not discovered from its own pages**, which link only the back end and the image CDN. It needs the rule Teamtailor has in `discover.py`: a page with the markers means the page's host is the board, checked by reading `/search/`. Until then such a board is set by hand.
- **HR Manager's portal disallows reading in robots.txt, its feed host has no robots.txt.** The module checks the feed's host, so a board would be read. Seaborg, the one company on it, is not attached until the owner decides whether the feed counts as allowed.
- **Six new hosts' dates are not trusted** (Eightfold, Jibe, Gem, Deel, HiBob, HR Manager; Pinpoint states none), so their backlog counts as posted when first seen. Check each date on a live board and add the host to `TRUSTED_POSTED_HOSTS`.
- **SmartRecruiters and Workable roles have no text.** Their lists carry none and their modules have no `detail`, so 7,391 open roles (Bosch, Wise, Ubisoft, Delivery Hero) are ranked on the title alone. Both hosts have a per-posting endpoint; a `detail` in each module fills the text 200 roles per board per pull.
- **A posting fetched by hand feeds the reader only.** "Fetch the posting" stores `article_text`, which `summarise` reads and `embed` and `extract` do not.
- **A list's teaser is not stored.** Phenom's and Oracle's lists carry a short description, which is dropped so that it cannot replace the full text; until the role's page is read the role has no text at all.