Engineering Standards

This is a live document. We update this document every now and then.

Handling Pull Requests

A great pull request starts with a great title and description with the reviewer’s mindset in mind.

What is not a great pull request?

A PR is not great if:

  • It’s been raised for the sake of merging code to the main or other branches.
  • It’s been raised without a reviewer.
  • It’s been raised without reviewing your own code.

What is a great pull request?

This is the type of PR that is expected from you at Skcript.

A PR is great if:

  • It has a great title that follows the conventional commit message guidelines.
  • It has a great description, along with appropriate attachments. For example, if you are fixing a bug, attach screenshots or videos.
  • It has been tested, and you are confident that it works as expected.
  • It has appropriate labels, and task IDs attached to it.
  • Your code is clean, free of linting errors, and is aligned with the main branch.

Tips on writing great PR descriptions

  • Please use Cursor or Copilot to write your PR description. They are great at this. Save time for yourself.
  • If you are writing on your own, sit down, think through, and write a concise description.

More to come.