{"id":30240415,"url":"https://github.com/hypothesis/onboarding","last_synced_at":"2026-02-26T06:28:40.247Z","repository":{"id":59847046,"uuid":"515570755","full_name":"hypothesis/onboarding","owner":"hypothesis","description":"The Hypothesis new engineer onboarding process.","archived":false,"fork":false,"pushed_at":"2025-03-27T10:44:23.000Z","size":609,"stargazers_count":4,"open_issues_count":12,"forks_count":1,"subscribers_count":5,"default_branch":"main","last_synced_at":"2025-08-15T04:42:38.850Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":"","language":null,"has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"bsd-2-clause","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/hypothesis.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null}},"created_at":"2022-07-19T12:13:32.000Z","updated_at":"2025-03-27T10:44:25.000Z","dependencies_parsed_at":"2025-08-15T04:38:38.849Z","dependency_job_id":"883eaac6-87d5-4597-a854-0ad013b35516","html_url":"https://github.com/hypothesis/onboarding","commit_stats":null,"previous_names":[],"tags_count":0,"template":false,"template_full_name":null,"purl":"pkg:github/hypothesis/onboarding","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/hypothesis%2Fonboarding","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/hypothesis%2Fonboarding/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/hypothesis%2Fonboarding/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/hypothesis%2Fonboarding/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/hypothesis","download_url":"https://codeload.github.com/hypothesis/onboarding/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/hypothesis%2Fonboarding/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":281896645,"owners_count":26580138,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","status":"online","status_checked_at":"2025-10-30T02:00:06.501Z","response_time":61,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":true,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":[],"created_at":"2025-08-15T04:38:27.880Z","updated_at":"2025-10-30T22:39:51.544Z","avatar_url":"https://github.com/hypothesis.png","language":null,"funding_links":[],"categories":[],"sub_categories":[],"readme":"Onboarding\n==========\n\nThis repo defines the Hypothesis new engineer onboarding process:\n\n* [Issue templates](.github/ISSUE_TEMPLATE) in this repo help to create the\n  onboarding issues for each new engineer\n* [Project boards](https://github.com/hypothesis/onboarding/projects) in this\n  repo keep track of each new engineer's onboarding progress\n* [The docs folder](docs) in this repo contains the documentation and guides\n  that a new engineer will need: our architecture, core practices, etc\n* To report a problem or suggest an improvement to the onboarding process\n  [open an issue](https://github.com/hypothesis/onboarding/issues/new) or\n  [create a pull request](https://github.com/hypothesis/onboarding/compare)\n\nCreating an onboarding project for a new engineer\n-------------------------------------------------\n\nBefore a new engineer's first day we need to create a\n[GitHub project](https://docs.github.com/en/issues/planning-and-tracking-with-projects)\nfor their onboarding. To create an onboarding project:\n\n1. [Create a new project](https://github.com/orgs/hypothesis/projects) in the Hypothesis organization.\n   Select the **Board** layout for this new project.\n\n2. Give the new project a title/name like **@seanh Onboarding**.\n\n3. Add the new project to this onboarding repo for quick access:\n   go to [the onboarding repo's **Projects** tab](https://github.com/hypothesis/onboarding/projects)\n   and use the **Add project** button.\n\n4. Create issues in the onboarding repo and add them to the project:\n\n   1. Go to the onboarding repo's [new issue page](https://github.com/hypothesis/onboarding/issues/new/choose)\n      and create an issue from one of the templates or use the **Open a blank issue** link:\n\n      ![Choosing an issue template](docs/images/choosing_an_issue_template.png)\n\n   2. Use the **Assignees** section in the issue's sidebar to assign the issue\n      to the new engineer and the **Projects** section to add the issue to the\n      onboarding project you created for the new engineer:\n\n      ![Adding an issue to a project](docs/images/adding_an_issue_to_a_project.png)\n\n   3. Repeat until you've finished adding an initial set of issues\n\n\n### We can vary the onboarding tasks from one new engineer to the next\n\nThe idea is to populate each new engineer's project with a sequence of issues\ncreated from the templates provided. We can vary the tasks from one new\nengineer to the next:\n\n* You don't have to pre-populate the whole project at the start, you can add more issues later\n* You don't have to use all of the issue templates\n* You don't have to use the issue templates in the suggested order\n* After creating an issue from a template you can edit the issue\n* You can use the **Open a blank issue** link to create an issue without using a template\n\n### We can add other issues to an onboarding project\n\nYou should also add issues from other repos to an engineer's onboarding project.\nThe issue templates aren't meant to be all a new engineer does during their\nonboarding time. We don't expect them to set up their development environment,\nwrite one PR, review one PR, and then find themselves on-call! The idea is that\nthey'll also be assigned other tasks during their onboarding time. For example:\n\n* When the new engineer has deployed their first PR they can close their\n  _Make your first pull request_ issue.\n* They're now capable of making pull requests to fix simple issues, getting\n  them approved, and deploying them, so their manager and buddy can help them\n  find several more issues to fix with PRs.\n* At some point the engineer decides, along with their buddy and manager, that\n  they're ready to move on to the next phase of onboarding (say: handling\n  Dependabot PRs).\n* When they've deployed their first batch of Dependabot PRs the engineer can\n  close their _Deploy your first batch of Dependabot PRs_ issue.\n* They're now capable of handling Dependabot PRs and can handle their share of\n  those from now on.\n* And so on\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fhypothesis%2Fonboarding","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fhypothesis%2Fonboarding","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fhypothesis%2Fonboarding/lists"}