Stratorys Onboarding

Appearance

Open your first pull request ​

Goal: You clone a repo, make a change, push a branch, and open a PR. You've done the full cycle once.

Time: ~15 minutes.

Step 1: Clone a repository ​

Ask your team lead which repo to start with. Then:

bash
git clone git@github.com:stratorys/<repo-name>.git
bash
cd <repo-name>

Step 2: Create a branch ​

bash
git checkout -b feat/add-your-name

Branch names follow the pattern: feat/description, fix/description, or chore/description.

Step 3: Make a change ​

Add your name to the team list, a README, or any file your lead points you to. Keep it small - this is about the process, not the change.

Step 4: Commit with a semantic message ​

bash
git add <file>
bash
git commit -m "chore: add <your-name> to team list"

The commit format is type(scope): description. See the semantic commits reference for details.

Step 5: Push your branch ​

bash
git push -u origin feat/add-your-name

Step 6: Open the PR ​

Go to the repository on GitHub. You'll see a banner to create a pull request.

  1. Write a short title: chore: add <your-name> to team list
  2. Add a one-line description of what you changed
  3. Request a review from your team lead

Step 7: Address feedback ​

Your reviewer may leave comments. This is normal and expected - it's how the team maintains quality. Read each comment, make the changes, push again.

Done when ​

  • Your PR is open on GitHub
  • Your commits are signed (green "Verified" badge)
  • A teammate has reviewed it
  • It's merged

Next: Read your role-specific page - Software engineer or Data engineer