Repository navigation
Community Portals is live: own the job boards you search #827
jakob1379
announced in
Announcements
Replies: 0 comments
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
Uh oh!
There was an error while loading. Please reload this page.
TL;DR: community-portals is now public. It's where the job boards for each market live, contributed and owned by the people who use them. If your board is missing or broken, you can now fix and contribute more easily and own it, with no need to wait on us.
Why we split it out
We built AI Job Search to be market-neutral on purpose. The framework should work the same in Copenhagen, Berlin or Toronto, so we've been turning down country-specific portals in the main repo. That kept the core clean, but it left a bad taste: all your amazing work on the local job board, the one you actually use, had nowhere to go.
Many of you filled that gap anyway, with forks, gists and portals that lived on one laptop. That's good work not put to its best use. With Community Portals, we aim to give it a proper home.
What's in it today
jobindex-search,jobnet-search,jobbank-search,jobdanmark-searchlinkedin-search,freehire-searchfreehire-searchis owned by @strelov1, our first community owner. Thanks, Ilya!What "you own it" means
This is the core idea, so here are the specifics:
We (@jakob1379, @MadsLorentzen) review what enters the repo and keep it safe. We don't maintain your portal for you, and that's the point: you know your market's boards better than we do.
How to get involved
Use a portal. Ask your agent in your AI Job Search checkout:
Read a portal's code before you run it. It runs against your career data.
Add your board. Run
/add-portalin AI Job Search, copy the generated folder toportals/<country>/<board>-search/, add yourself to.github/CODEOWNERS, and open a PR. The review bar isn't code polish. It's five things: the portal contract, a safety pass, honest scoping, respecting robots.txt and terms, and search only (no auto-applying). CONTRIBUTING.md has the details.Adopt or co-own one. Using
jobnet-searchevery day? Add your handle to its CODEOWNERS line.Report a broken portal with the Portal broken issue template.
Already have a fork?
Full market or language adaptations still belong in Community forks & adaptations. If your fork has a portal in it, though, consider upstreaming just that portal here. That way everyone in your market benefits, and the next framework update won't leave it behind.
Which job board do you search most that isn't on the list yet? Reply with the board and your market. If you're up for owning it, say so and we'll help you get the first PR through.
All reactions