You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
Right now we do not have any specific format for approval of the overall design for a given change to the code. Some changes may not need it (they are small and/or fix an obvious issue in an obvious way). However, some changes may have uncertain implications and/or multiple possible solutions that could work. Making the code first and having to rework much of it due to design problems can be wasteful.
Proposed Solution
Instead of making code right away, one possible process could be:
Create issue just like this one
Assign people to review the issue same as you would for PR
Follow the discussion and iterate on the ideas for the design of a future PR. When appropriate, add "design approved" label.
Now the code can be made and a new PR linked to issue can be created
PR goes through review as usual
PR gets approved & merged
If the issue is fully resolved, it can be closed, else more PRs can be linked to it.
Feedback is welcome!
The text was updated successfully, but these errors were encountered:
I agree. Picking the right people for step 2 is probably the trickiest part for new-ish people, but this can be learned over time or outsourced to old-timers.
I don't think we need to cudgel people into using this exact format (Github issue) for achieving design consensus, but the general steps/principles you outlined can hold regardless of the format. Getting tacit approval in Discord might suffice.
The nice thing with this is the incentive alignment is already there. If you want to bypass the process and jump straight to PR but get a design nack, you feel the pain.
Problem
Right now we do not have any specific format for approval of the overall design for a given change to the code. Some changes may not need it (they are small and/or fix an obvious issue in an obvious way). However, some changes may have uncertain implications and/or multiple possible solutions that could work. Making the code first and having to rework much of it due to design problems can be wasteful.
Proposed Solution
Instead of making code right away, one possible process could be:
Feedback is welcome!
The text was updated successfully, but these errors were encountered: