Building Career Capital Through Open Source

// ❌ Scattered approach: contributing to random trending repos
const scatteredContributions = [
  { repo: "random-css-framework", type: "typo-fix", impact: "negligible" },
  { repo: "abandoned-utility", type: "feature", impact: "nobody-sees-it" },
  { repo: "mega-project", type: "docs-typo", impact: "lost-in-noise" },
];
 
// ✅ Strategic approach: deep contributions to relevant projects
interface ContributionStrategy {
  project: string;
  reason: string;
  targetArea: string;
  careerAlignment: string;
}
 
const strategicPlan: ContributionStrategy[] = [
  {
    project: "next.js",
    reason: "I use it daily and understand the pain points",
    targetArea: "middleware and routing",
    careerAlignment: "Full-stack React expertise",
  },
  {
    project: "prisma",
    reason: "Our team hits edge cases regularly",
    targetArea: "query optimization and error handling",
    careerAlignment: "Database and backend depth",
  },
  {
    project: "playwright",
    reason: "Testing is my team's weak spot",
    targetArea: "browser context management",
    careerAlignment: "Quality engineering leadership",
  },
];

interface ContributionLevel {
  stage: string;
  examples: string[];
  timeframe: string;
  visibility: string;
}
 
const contributionLadder: ContributionLevel[] = [
  {
    stage: "Observer",
    examples: [
      "Read contributing guidelines",
      "Study recent merged PRs",
      "Understand issue triage process",
      "Set up local development environment",
    ],
    timeframe: "Week 1-2",
    visibility: "None — this is research",
  },
  {
    stage: "Bug Fixer",
    examples: [
      "Fix issues labeled 'good first issue'",
      "Add missing test cases",
      "Fix flaky tests",
      "Improve error messages",
    ],
    timeframe: "Week 3-6",
    visibility: "Low — but you are building trust",
  },
  {
    stage: "Feature Contributor",
    examples: [
      "Implement small features from roadmap",
      "Propose and build improvements",
      "Review other contributors PRs",
    ],
    timeframe: "Month 2-4",
    visibility: "Medium — maintainers know your name",
  },
  {
    stage: "Trusted Contributor",
    examples: [
      "Design and implement significant features",
      "Mentor new contributors",
      "Participate in architecture discussions",
      "Help with release processes",
    ],
    timeframe: "Month 4+",
    visibility: "High — you are part of the project",
  },
];

// ❌ PR description that creates work for reviewers
const badPRDescription = `
Fixed the thing. Added some tests.
`;
 
// ✅ PR description that accelerates review
const goodPRDescription = `
## Problem
When users pass an array with mixed types to \`parseConfig()\`,
the function silently coerces values instead of throwing a
validation error. This causes confusing downstream failures
(ref: #2847, #2903).
 
## Solution
Added type checking at the entry point of \`parseConfig()\`
that validates array homogeneity before processing. Throws
a descriptive \`ConfigValidationError\` with the index and
types of mismatched elements.
 
## Changes
- Added \`validateArrayTypes()\` in src/config/validation.ts
- Updated \`parseConfig()\` to call validation before processing
- Added 6 test cases covering mixed-type arrays
- Updated error documentation in docs/errors.md
 
## Testing
- All existing tests pass
- New tests cover: mixed primitives, mixed objects,
  nested arrays, empty arrays, single-element arrays,
  and null handling
`;

interface MergeablePR {
  scopeIsMinimal: boolean;
  testsAreIncluded: boolean;
  existingTestsPass: boolean;
  descriptionExplainsWhy: boolean;
  followsProjectConventions: boolean;
  linkedToIssue: boolean;
}
 
function assessMergeability(pr: MergeablePR): string {
  const checks = Object.entries(pr);
  const failures = checks.filter(([, passed]) => !passed);
 
  if (failures.length === 0) {
    return "Ready for review — high merge probability";
  }
 
  return `Address before submitting:\n${failures
    .map(([check]) => `  - ${check.replace(/([A-Z])/g, " $1").toLowerCase()}`)
    .join("\n")}`;
}

interface CareerOpportunity {
  source: string;
  mechanism: string;
  examples: string[];
}
 
const opportunities: CareerOpportunity[] = [
  {
    source: "Direct recruiter interest",
    mechanism: "Engineering managers search GitHub for active contributors to their stack",
    examples: [
      "Recruiter reaches out after seeing your React contributions",
      "Company contacts you because you fixed a bug they were tracking",
    ],
  },
  {
    source: "Conference speaking",
    mechanism: "Deep knowledge of a project qualifies you for talks about it",
    examples: [
      "Talk about internals of a framework you contributed to",
      "Workshop on testing patterns you helped standardize",
    ],
  },
  {
    source: "Maintainer referrals",
    mechanism: "Maintainers work at companies and refer contributors",
    examples: [
      "Maintainer recommends you for a role at their company",
      "Project sponsor hires contributors for related work",
    ],
  },
];

interface ContributionPortfolioEntry {
  project: string;
  contribution: string;
  prLink: string;
  blogPost: string | null;
  skillsDemonstrated: string[];
}
 
const portfolio: ContributionPortfolioEntry[] = [
  {
    project: "prisma",
    contribution: "Optimized query batching for nested includes",
    prLink: "https://github.com/prisma/prisma/pull/XXXX",
    blogPost: "How Prisma Batches Nested Queries (And Why It Matters)",
    skillsDemonstrated: [
      "Database query optimization",
      "TypeScript generics",
      "Performance profiling",
    ],
  },
  {
    project: "playwright",
    contribution: "Fixed race condition in browser context cleanup",
    prLink: "https://github.com/microsoft/playwright/pull/XXXX",
    blogPost: null,
    skillsDemonstrated: [
      "Concurrency debugging",
      "Browser internals",
      "Test reliability",
    ],
  },
];