Skip to content

Instantly share code, notes, and snippets.

@ryancwalsh
Created May 28, 2025 19:56
Show Gist options
  • Save ryancwalsh/f5c222255b6835eb6c82af76aea80969 to your computer and use it in GitHub Desktop.
Save ryancwalsh/f5c222255b6835eb6c82af76aea80969 to your computer and use it in GitHub Desktop.
Welcome file

Intro

During my recent job search (in fall 2020), I observed a wide range in the attractiveness of job descriptions and recruiting processes.

I took notes on my preferences (tried to assemble “the best of the best”) in case it would be useful for when my future teammates needed to recruit someone new.

Goals

  1. Attract excellent candidates.

  2. Quickly and efficiently filter down to the best match.

  3. Assess whether they are a “culture add” (seeking to diversify our team and also share values)

  4. Test their problem-solving logic

  5. Test their written communication skills

  6. Way more important than most people acknowledge.

  7. Test their leadership skills

  8. Test their coding skills

  9. Assess their personality

  10. Treat candidates fairly.

  11. Avoid biases against candidates based on:

  12. Skin color, birth sex, gender identity, sexual orientation, age, religion, culture, national origin, ancestry, marital status, parental status, physical or mental disability, veteran status, etc (and keep in mind that discriminating against candidates with tight schedules is a bias too)

  13. Gather a reserve list of candidates for future openings.

  14. Generate a positive impression of our company (high Net Promoter Score).

  15. Clear, friendly, quick communication

  16. Comply with laws.

  17. Advertise our product (mostly relevant for small employers)

Where to Advertise Job Openings

  1. To our reserve list of past great candidates

  2. On our public website

  3. Frequently mentioned in internal communications to gather referrals from existing team.

  4. Countless times I’ve heard that referrals are the source of the best candidates in the easiest and quickest (and probably cheapest) way. But usually companies don’t do nearly enough to take advantage of this channel.

  5. Special networks like https://alumni.bridgewater.com/

  6. AngelList https://angel.co/jobs

  7. StackOverflow https://stackoverflow.com/jobs

  8. Indicates whether listing poster has a high response rate

  9. LinkedIn https://www.linkedin.com/talent/post-a-job?trk=homepage-jobseeker_talent-finder-cta

  10. EasyApply

  11. Glassdoor

  12. Reviews of company, EasyApply, estimated salary

  13. https://weworkremotely.com/categories/remote-programming-jobs#job-listings

  14. https://remoteok.io/

  15. https://remotewoman.com/remote-developer-jobs/

  16. https://www.workingnomads.co/jobs?category=development

  17. Certain email newsletters that developers subscribe to

Pages That Our Company Website Should Have

Characteristics of the Most Effective Job Descriptions

  • Point to those important pages on our website.

  • Provide compensation info (such as a range of possible base salary).

  • Lack of compensation range is such a deterrent for candidates (who don’t want to risk wasting tons of time in the process of a company that ultimately won’t be a fit).

  • List out benefits, including intangible ones (flexible hours, moral equity).

  • Include powerful, inspirational short mission statement about the company at top

  • Mention that we care more about ability to learn, grow, think logically, and be creative than we do about past skills and specific languages.

  • (Sometimes it might even be best to say “We’re language agnostic.”)

  • Add sections like “We’ll be crazy impressed if you…”

  • https://web.archive.org/web/20200901125446/https://angel.co/company/guitar-mastery-intensive/jobs/957027-mid-stack-frontend-engineer-for-fast-scaling-music-learning-platform

  • Offer a fast-track scheduling process such as at https://web.archive.org/web/20200901125446/https://angel.co/company/guitar-mastery-intensive/jobs/957027-mid-stack-frontend-engineer-for-fast-scaling-music-learning-platform

  • I think some of the biggest factors that matter to applicants are clarity of feedback and speed of progress through the process. Job hunting tends to be very boring and frustrating and unclear, so we want to be the antidote to that.

  • I thought this was a good couple sentences about diversity and inclusion (although something more company-specific would be better):

  • [Capital Rx / Company Name] values a diverse workplace and celebrates the diversity that each employee brings to the table. We are proud to provide equal employment opportunities to all employees and applicants for employment and prohibit discrimination and harassment of any type without regard to race, color, religion, age, sex, national origin, disability status, medical condition, genetic information, protected veteran status, sexual orientation, gender identity or expression, or any other characteristic protected by federal, state or local laws.

  • Provide the expectations for first 1-6 months:

  • https://web.archive.org/web/20200920224612/https://niche.jazz.co/apply/O2fahANUHA/Sr-Software-Engineer-Front-End?source=STCK

  • GU might require internal changes first, and then these features would be great to add:

  • See “We are committed to continuous improvement and track our team’s progress with this Product Development Team Self-Assessment. (Ask us for our latest scores with commentary!)”

  • https://web.archive.org/web/20201007131557/https://angel.co/company/mentorcollective/jobs/542902-senior-software-engineer

  • Add a note like: unlike nearly every other company, instead of treating negotiations as adversarial, where we'd withhold as much information as possible in order to spend the least possible on a new hire, we go ahead and treat our recruits with the full respect they'd have if they were already long term employees. We want to be as transparent as possible. We know that it adds risk, but investing early in our long term relationship of care and trust is important.

How to Efficiently Identify the Best Applicant (WIP)

Other Thoughts

  • Don’t require candidates to screenshare in an interview since candidates are on personal computers and have private stuff visible (especially if no prior notice was given).

  • Don’t require signing an NDA at any point in the recruiting process until the candidate and the company have decided a mutual fit and that the candidate will be joining. It’s obnoxious when a company puts up that wall of legalese as one of their first interactions with a candidate.

  • Once the candidate chooses to join, what can we do to offer huge congratulations?

  • The candidate could feel like he/she just finished some impossible challenge like the Iditarod, so the typical “We’re happy to have you” could sound like a major letdown. Show major enthusiasm and appreciation.

  • Maybe we could have a special webpage with fireworks and a welcome video from the team, etc.

  • After signing, before start date: send a welcome package with a warm letter (maybe including a photo of the team) and swag (such as fleece, mug with company logo, etc).

  • The candidate busted their tail during the process and chose you. Extra warmth will be a great beginning to a hopefully very long and fulfilling relationship (not just as employer-employee but hopefully real friendships too).

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment