From fe335fb8b5a3cfb57f7dcf8f30475bf84ecf6fea Mon Sep 17 00:00:00 2001 From: Manfred Touron <94029+moul@users.noreply.github.com> Date: Sat, 30 Sep 2023 17:43:56 +0200 Subject: [PATCH 1/5] feat: bootstrap the engineering workflows page --- docs/engineering/workflows/intro.md | 42 +++++++++++++++++++++++++++++ 1 file changed, 42 insertions(+) create mode 100644 docs/engineering/workflows/intro.md diff --git a/docs/engineering/workflows/intro.md b/docs/engineering/workflows/intro.md new file mode 100644 index 0000000..9945818 --- /dev/null +++ b/docs/engineering/workflows/intro.md @@ -0,0 +1,42 @@ +# Engineering Workflows + +Our guiding philosophies are **Flexibility** and **Polar Adaptability**. +These principles underline our belief in processes that are encouraged rather than enforced, +ensuring that while we benefit from structure, +it doesn't come at the cost of innovation or situational needs. + +## Flexibility & Polar Adaptability in Practice: + +- **Fast Iterations vs. Protected Slow Processes**: Some tasks thrive on quick cycles, continuous adaptation, and inter-team dependencies. + On the other end of the spectrum, certain endeavors, especially discussions and research, need to move at a deliberate, protected pace. + This slower approach ensures that they're not rushed, preventing premature conclusions. + Both extremes have their place, and we champion the value of each. +- **Varied Review Depths**: While crucial tasks necessitate thorough reviews and extensive unit testing, others are straightforward. + For the simpler tasks, we leave the choice to the individual—either opt for a review or take full ownership of the potential consequences. + +## Workflows: + +We offer several suggested workflows. +Teams can either adopt one of these or pave their own path, as long as it aligns with our overarching philosophies. + +### 1. **Infinito Tablero** (Infinite Kanban) +- For small and medium teams tackling complex projects. +[Details](./infinito-tablero.md) + +### 2. **Rigorous & Deliberate** +- Prioritizes depth and broad collaboration, even with part-timers or external contributors. +[Details](./rigorous-deliberate.md) + +### 3. **Criteria-Based** +- Clear objectives for engagements with less visibility into our broader goals. +[Details](./criteria-based.md) + +### 4. **Your Proposal Here** +We encourage innovative approaches. If you see a need, propose a new workflow. + +## Key Points: + +- **Hierarchical Structure**: Projects within our system are built hierarchically. This means top-tier projects act as the umbrella, orchestrating and overseeing sub-projects to ensure alignment and efficiency. +- **Unique Yet Unified**: While each team or project can define its own unique set of rules, it's expected that many will find alignment with established conventions. This balance fosters both innovation and consistency. +- **Smart Communication**: Every team member plays a crucial role in maintaining clarity. Gone are the days of endlessly scouring dashboards. Instead, we focus on smart, effective, and timely communication to keep everyone in the loop. +- **Flexibility Above All**: At the heart of our operations is flexibility. While processes serve as valuable roadmaps, they shouldn't feel restrictive. Every team member is empowered to adapt processes when it's in the best interest of the team and the mission at large. From 523d9272f8279a8f18b1aa5af563c82190e28216 Mon Sep 17 00:00:00 2001 From: moul <94029+moul@users.noreply.github.com> Date: Sat, 30 Sep 2023 17:48:10 +0200 Subject: [PATCH 2/5] chore: fixup Signed-off-by: moul <94029+moul@users.noreply.github.com> --- docs/engineering/workflows/intro.md | 45 +++++++++++++++++++---------- 1 file changed, 29 insertions(+), 16 deletions(-) diff --git a/docs/engineering/workflows/intro.md b/docs/engineering/workflows/intro.md index 9945818..9494558 100644 --- a/docs/engineering/workflows/intro.md +++ b/docs/engineering/workflows/intro.md @@ -1,23 +1,27 @@ # Engineering Workflows -Our guiding philosophies are **Flexibility** and **Polar Adaptability**. -These principles underline our belief in processes that are encouraged rather than enforced, -ensuring that while we benefit from structure, -it doesn't come at the cost of innovation or situational needs. +Our guiding philosophies are **Flexibility** and **Polar Adaptability**. These +principles underline our belief in processes that are encouraged rather than +enforced, ensuring that while we benefit from structure, it doesn't come at the +cost of innovation or situational needs. ## Flexibility & Polar Adaptability in Practice: -- **Fast Iterations vs. Protected Slow Processes**: Some tasks thrive on quick cycles, continuous adaptation, and inter-team dependencies. - On the other end of the spectrum, certain endeavors, especially discussions and research, need to move at a deliberate, protected pace. - This slower approach ensures that they're not rushed, preventing premature conclusions. - Both extremes have their place, and we champion the value of each. -- **Varied Review Depths**: While crucial tasks necessitate thorough reviews and extensive unit testing, others are straightforward. - For the simpler tasks, we leave the choice to the individual—either opt for a review or take full ownership of the potential consequences. +- **Fast Iterations vs. Protected Slow Processes**: Some tasks thrive on quick + cycles, continuous adaptation, and inter-team dependencies. On the other end + of the spectrum, certain endeavors, especially discussions and research, need + to move at a deliberate, protected pace. This slower approach ensures that + they're not rushed, preventing premature conclusions. Both extremes have their + place, and we champion the value of each. +- **Varied Review Depths**: While crucial tasks necessitate thorough reviews and + extensive unit testing, others are straightforward. For the simpler tasks, we + leave the choice to the individual—either opt for a review or take full + ownership of the potential consequences. ## Workflows: -We offer several suggested workflows. -Teams can either adopt one of these or pave their own path, as long as it aligns with our overarching philosophies. +We offer several suggested workflows. Teams can either adopt one of these or +pave their own path, as long as it aligns with our overarching philosophies. ### 1. **Infinito Tablero** (Infinite Kanban) - For small and medium teams tackling complex projects. @@ -36,7 +40,16 @@ We encourage innovative approaches. If you see a need, propose a new workflow. ## Key Points: -- **Hierarchical Structure**: Projects within our system are built hierarchically. This means top-tier projects act as the umbrella, orchestrating and overseeing sub-projects to ensure alignment and efficiency. -- **Unique Yet Unified**: While each team or project can define its own unique set of rules, it's expected that many will find alignment with established conventions. This balance fosters both innovation and consistency. -- **Smart Communication**: Every team member plays a crucial role in maintaining clarity. Gone are the days of endlessly scouring dashboards. Instead, we focus on smart, effective, and timely communication to keep everyone in the loop. -- **Flexibility Above All**: At the heart of our operations is flexibility. While processes serve as valuable roadmaps, they shouldn't feel restrictive. Every team member is empowered to adapt processes when it's in the best interest of the team and the mission at large. +- **Hierarchical Structure**: Projects within our system are built + hierarchically. This means top-tier projects act as the umbrella, + orchestrating and overseeing sub-projects to ensure alignment and efficiency. +- **Unique Yet Unified**: While each team or project can define its own unique + set of rules, it's expected that many will find alignment with established + conventions. This balance fosters both innovation and consistency. +- **Smart Communication**: Every team member plays a crucial role in maintaining + clarity. Gone are the days of endlessly scouring dashboards. Instead, we focus + on smart, effective, and timely communication to keep everyone in the loop. +- **Flexibility Above All**: At the heart of our operations is flexibility. + While processes serve as valuable roadmaps, they shouldn't feel restrictive. + Every team member is empowered to adapt processes when it's in the best + interest of the team and the mission at large. From fc4d9925256ad795c59cdce336e0043128ced756 Mon Sep 17 00:00:00 2001 From: moul <94029+moul@users.noreply.github.com> Date: Sat, 30 Sep 2023 17:48:29 +0200 Subject: [PATCH 3/5] chore: fixup Signed-off-by: moul <94029+moul@users.noreply.github.com> --- docs/engineering/workflows/intro.md | 3 ++- 1 file changed, 2 insertions(+), 1 deletion(-) diff --git a/docs/engineering/workflows/intro.md b/docs/engineering/workflows/intro.md index 9494558..9f20362 100644 --- a/docs/engineering/workflows/intro.md +++ b/docs/engineering/workflows/intro.md @@ -28,7 +28,8 @@ pave their own path, as long as it aligns with our overarching philosophies. [Details](./infinito-tablero.md) ### 2. **Rigorous & Deliberate** -- Prioritizes depth and broad collaboration, even with part-timers or external contributors. +- Prioritizes depth and broad collaboration, even with part-timers or external + contributors. [Details](./rigorous-deliberate.md) ### 3. **Criteria-Based** From 63ffc7ce1edd928a3f7bedd411b81ffe11965b4c Mon Sep 17 00:00:00 2001 From: moul <94029+moul@users.noreply.github.com> Date: Sat, 30 Sep 2023 17:52:47 +0200 Subject: [PATCH 4/5] chore: fixup Signed-off-by: moul <94029+moul@users.noreply.github.com> --- spell-check-dictionary.txt | 6 +++++- 1 file changed, 5 insertions(+), 1 deletion(-) diff --git a/spell-check-dictionary.txt b/spell-check-dictionary.txt index 3befbec..b197b5c 100644 --- a/spell-check-dictionary.txt +++ b/spell-check-dictionary.txt @@ -105,4 +105,8 @@ Gnodaos dApp Berty Dev -devs \ No newline at end of file +devs +Kanban +Infinito +Tablero +roadmaps From 71323b28b41b45b5d0c13ec29a1d59708326b510 Mon Sep 17 00:00:00 2001 From: moul <94029+moul@users.noreply.github.com> Date: Sun, 1 Oct 2023 13:42:10 +0200 Subject: [PATCH 5/5] chore: fixup Signed-off-by: moul <94029+moul@users.noreply.github.com> --- docs/engineering/workflows/intro.md | 100 +++++++++++++--------------- 1 file changed, 46 insertions(+), 54 deletions(-) diff --git a/docs/engineering/workflows/intro.md b/docs/engineering/workflows/intro.md index 9f20362..c57a2a3 100644 --- a/docs/engineering/workflows/intro.md +++ b/docs/engineering/workflows/intro.md @@ -1,56 +1,48 @@ # Engineering Workflows -Our guiding philosophies are **Flexibility** and **Polar Adaptability**. These -principles underline our belief in processes that are encouraged rather than -enforced, ensuring that while we benefit from structure, it doesn't come at the -cost of innovation or situational needs. - -## Flexibility & Polar Adaptability in Practice: - -- **Fast Iterations vs. Protected Slow Processes**: Some tasks thrive on quick - cycles, continuous adaptation, and inter-team dependencies. On the other end - of the spectrum, certain endeavors, especially discussions and research, need - to move at a deliberate, protected pace. This slower approach ensures that - they're not rushed, preventing premature conclusions. Both extremes have their - place, and we champion the value of each. -- **Varied Review Depths**: While crucial tasks necessitate thorough reviews and - extensive unit testing, others are straightforward. For the simpler tasks, we - leave the choice to the individual—either opt for a review or take full - ownership of the potential consequences. - -## Workflows: - -We offer several suggested workflows. Teams can either adopt one of these or -pave their own path, as long as it aligns with our overarching philosophies. - -### 1. **Infinito Tablero** (Infinite Kanban) -- For small and medium teams tackling complex projects. -[Details](./infinito-tablero.md) - -### 2. **Rigorous & Deliberate** -- Prioritizes depth and broad collaboration, even with part-timers or external - contributors. -[Details](./rigorous-deliberate.md) - -### 3. **Criteria-Based** -- Clear objectives for engagements with less visibility into our broader goals. -[Details](./criteria-based.md) - -### 4. **Your Proposal Here** -We encourage innovative approaches. If you see a need, propose a new workflow. - -## Key Points: - -- **Hierarchical Structure**: Projects within our system are built - hierarchically. This means top-tier projects act as the umbrella, - orchestrating and overseeing sub-projects to ensure alignment and efficiency. -- **Unique Yet Unified**: While each team or project can define its own unique - set of rules, it's expected that many will find alignment with established - conventions. This balance fosters both innovation and consistency. -- **Smart Communication**: Every team member plays a crucial role in maintaining - clarity. Gone are the days of endlessly scouring dashboards. Instead, we focus - on smart, effective, and timely communication to keep everyone in the loop. -- **Flexibility Above All**: At the heart of our operations is flexibility. - While processes serve as valuable roadmaps, they shouldn't feel restrictive. - Every team member is empowered to adapt processes when it's in the best - interest of the team and the mission at large. +**Central Tenet**: **Simplicity through Automation**. Our aim: lean on CI/automation and eliminate manual rule enforcement. + +**Disclaimer**: Our workflows will adapt and evolve as automation capabilities expand. Our vision is a future with fewer manual interventions and increased reliance on bot integrations. + +**Guiding Philosophies**: We believe in **Flexibility** and **Polar Adaptability**, fostering processes that offer adaptability without stifling creativity. + +**Workflow Principles**: +- **Composable & Adaptive**: These workflows can be combined, adjusted, or created from scratch. They’re tools, not constraints. +- **Continuous Optimization**: We encourage constant refinement of workflows to suit changing needs. +- **Freedom to Override**: When a workflow feels restrictive, it's encouraged to bypass it and assume responsibility for the results. + +## Workflows + +1. **Infinito Tablero** + - Ideal for: Complex projects in small to medium teams seeking a continuous flow approach. + [Details](./infinito-tablero.md) + +2. **Solo Voyager** + - Ideal for: High-autonomy tasks, specialists, side projects, or teams operating outside daily routines. Emphasizes high responsibility. + [Details](./solo-voyager.md) + +3. **Rigorous & Deliberate** + - Ideal for: Deep collaborative efforts. Suitable for inclusive participation, from part-timers to external contributors. + [Details](./rigorous-deliberate.md) + +4. **Rapid Prototyping** + - Ideal for: Fast-paced development phases where swift iteration and adaptability are paramount. + [Details](./rapid-prototyping.md) + +5. **Taskforce/Warzone** + - Ideal for: Intense focus scenarios, like hackathons, critical bugs, or product launches. Temporarily bypasses standard procedures. + [Details](./taskforce-warzone.md) + +6. **Criteria-Based** + - Ideal for: Projects with clear, quantifiable objectives, especially when deeper project goals are less visible. + [Details](./criteria-based.md) + +### Propose a Workflow +Identified a gap? Feel free to innovate and suggest. + +## Key Takeaways + +- **Hierarchy in Projects**: Projects are streamlined with a hierarchical structure ensuring cohesion across sub-projects. +- **Uniqueness & Unity**: While each team tailors its rules, a foundational common ground is maintained to foster unity. +- **Effective Communication**: We prioritize clear, concise communication over excessive chatter. +- **Ultimate Flexibility**: Processes serve as guidelines, not strict rules. Adaptation in the best interest of the mission is always prioritized.