Oliver Jägle commited on
Commit
c78995f
·
unverified ·
1 Parent(s): bc3274c

Clarify PRs in project organization

Browse files
Files changed (1) hide show
  1. PROJECT.md +12 -7
PROJECT.md CHANGED
@@ -1,11 +1,13 @@
1
  # Project management of bolt.diy
2
 
3
  First off: this sounds funny, we know. "Project management" comes from a world of enterprise stuff and this project is
4
- far from being enterprisy ;)
5
 
6
  But we need to organize ourselves somehow, right?
7
 
8
- So here's how we structure long-term vision, mid-term capabilities of the software and short term improvements.
 
 
9
 
10
  ## Strategic epics (long-term)
11
 
@@ -39,14 +41,17 @@ function, you name it).
39
  However, we intentionally describe features in a more vague manner. Why? Everybody loves crisp, well-defined
40
  acceptance-criteria, no? Well, every product owner loves it. because he knows what he’ll get once it’s done.
41
 
42
- But: **here is no owner of this product**. Therefore, we grant *maximum flexibility to the developer contributing a
43
- feature* – so that he can bring in his ideas and have most fun implementing it.
44
 
45
  The feature therefore tries to describe *what* should be improved but not in detail *how*.
46
 
47
  ## PRs as materialized features (short-term)
48
 
49
- Once a developer starts working on a feature, he/she can open a draft-PR asap to discuss / describe / share, how he/she
50
- is going to tackle the problem.
 
 
 
51
 
52
- Once it’s merged, a squashed commit contains the whole PR description which allows for a good change log.
 
 
1
  # Project management of bolt.diy
2
 
3
  First off: this sounds funny, we know. "Project management" comes from a world of enterprise stuff and this project is
4
+ far from being enterprisy- it's still anarchy all over the place 😉
5
 
6
  But we need to organize ourselves somehow, right?
7
 
8
+ > tl;dr: We've got a project board with epics and features. We use PRs as change log and as materialized features. Find it [here](https://github.com/orgs/stackblitz-labs/projects/4).
9
+
10
+ Here's how we structure long-term vision, mid-term capabilities of the software and short term improvements.
11
 
12
  ## Strategic epics (long-term)
13
 
 
41
  However, we intentionally describe features in a more vague manner. Why? Everybody loves crisp, well-defined
42
  acceptance-criteria, no? Well, every product owner loves it. because he knows what he’ll get once it’s done.
43
 
44
+ But: **here is no owner of this product**. Therefore, we grant *maximum flexibility to the developer contributing a feature* – so that he can bring in his ideas and have most fun implementing it.
 
45
 
46
  The feature therefore tries to describe *what* should be improved but not in detail *how*.
47
 
48
  ## PRs as materialized features (short-term)
49
 
50
+ Once a developer starts working on a feature, a draft-PR *can* be opened asap to share, describe and discuss, how the feature shall be implemented. But: this is not a must. It just helps to get early feedback and get other developers involved. Sometimes, the developer just wants to get started and then open a PR later.
51
+
52
+ In a loosely organized project, it may as well happen that multiple PRs are opened for the same feature. This is no real issue: Usually, peoply being passionate about a solution are willing to join forces and get it done together. And if a second developer was just faster getting the same feature realized: Be happy that it's been done, close the PR and look out for the next feature to implement 🤓
53
+
54
+ ## PRs as change log
55
 
56
+ Once a PR is merged, a squashed commit contains the whole PR description which allows for a good change log.
57
+ All authors of commits in the PR are mentioned in the squashed commit message and become contributors 🙌