Oliver Jägle
commited on
Clarify PRs in project organization
Browse files- 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 |
-
|
|
|
|
|
|
|
| 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,
|
| 50 |
-
|
|
|
|
|
|
|
|
|
|
| 51 |
|
| 52 |
-
Once
|
|
|
|
|
|
| 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 🙌
|