Skip to content

Development Process: Norms and Best Practices

Diwaker Gupta edited this page Feb 1, 2023 · 4 revisions

Background: See this discussion for more context. This page is a first attempt at capturing development norms and best-practices for Stacks blockchain developers, based on input from past and current contributors.

Task Scoping

  • Most tasks should be scoped such that they can be completed in 3-5 days.
  • Larger tasks should be broken down into smaller chunks before work begins. Any exceptions to this should be documented in the task.

Pull Requests

  • Well-scoped tasks should result in well-scoped PRs.
  • Reviewers are expected to provide feedback within 24 hours in the common case, and before 2 days in almost all cases.
  • If a reviewer is unable to provide feedback in 2 days, they should inform the PR author.
  • If the delay is because a PR is too large or complex, PR authors are responsible to either simplify the PR or ensure reviewers have sufficient context to do a timely review (e.g. via a code walk-through)
Clone this wiki locally