article: better words

README.md

@@ -1,12 +1,3 @@
 # Thinking People System
 
 A interactive website to better understand the Thinking People System.
-
-## Improvements
-
-### Pull system article
-
-- [ ] explaining 0 defect policy
-- [ ] work emoji is not contrastred enough and we don't understand it
-- [ ] complexity can be removed
-- [ ] add a visual to demonstrate a card is going backward and the card had a quality issue.

src/modules/pull-system/FlowArticle.vue

@@ -22,7 +22,7 @@ const feature: Feature = {
 </script>
 
 <template>
-  <div class="flow-article">
+  <article class="flow-article">
     <h1>Pull system</h1>
     <!-- <h2>Ekiden (駅伝): long-distance running relay race</h2> -->
     <div class="flow-intro text">
@@ -55,19 +55,16 @@ const feature: Feature = {
       </p>
     </div>
     <SeparatorIcon />
-    <div class="flow-hypothesis">
+    <!-- <div class="flow-hypothesis">
       We need some hypothesis to start with. Here are ours:
       <ol>
         <li>
-          The more feature done in parallel, the more it is difficult to focus
-          and it is more likely to introduce a defect.
         </li>
         <li>
-          it takes the same amount of time for each team to complete a task
+          it takes the same amount of time for each team to complete a task.
-          <span class="meaning">same task time</span>
         </li>
       </ol>
-      <!-- <p>Here our hypothesis:</p>
+      <p>Here our hypothesis:</p>
     <ol>
       <li>
         it takes the same amount of time for each team to complete a task
@@ -84,14 +81,14 @@ const feature: Feature = {
       </li>
       <li>release team never fails</li>
       <li>there is no limit on how many defects a feature can have.</li>
-    </ol> -->
+    </ol>
-    </div>
+    </div> -->
     <!-- <SeparatorIcon /> -->
     <div class="flow-setup text">
       <p>
-        The project who has just started, our goal is to make a product as fast
+        The project has just started, our goal is to make a product as fast as
-        as you can. With you, you'll have the product team, designers,
+        you can. You'll have teams dedicated to the product, the design, the
-        developers and a release team.
+        coding and one making sure it is going live.
       </p>
       <p>
         First things first, what is a feature? A feature is a piece of software
@@ -105,11 +102,12 @@ const feature: Feature = {
         It starts with the intention "<code>{{ feature.name }}</code
         >". This is what we'll add to the mobile app.
       </p>
+      <!-- [complexity]
       <p>
         <span class="numeric">({{ feature.complexity }})</span> is the
         complexity of the feature. The more complex a feature is, the more
         chance we introduce a defect.
-      </p>
+      </p> -->
       <p>
         <span class="numeric">{{ feature.leadTime }}d</span> is the number of
         days the teams work on the feature. The goal is to reduce this number
@@ -117,7 +115,7 @@ const feature: Feature = {
       </p>
       <p>
         <QualityIssue class="inline" :quality-issue="feature.qualityIssue" />
-        are the number of defects the feature had during the flow. For the sake
+        are the number of defects the feature has during the flow. For the sake
         of simplicity, we assume teams are capable of detecting every defects
         and we never deliver defects.
       </p>
@@ -128,18 +126,11 @@ const feature: Feature = {
       <!-- [dps] <p>Each day, you can choose between 3 strategies:</p> -->
       <p>Each day, you can choose between 2 strategies:</p>
       <ol>
-        <li>
+        <li><PushSystemIcon /> Push system</li>
-          <PushSystemIcon />
+        <li><PullSystemIcon /> Pull system</li>
-          Push system
-        </li>
-        <li>
-          <PullSystemIcon />
-          Pull system
-        </li>
         <!-- [dps]
       <li>
-        <ProblemSolvingIcon />
+        <ProblemSolvingIcon /> Problem solving
-        Problem solving
       </li> -->
       </ol>
       <p>
@@ -153,6 +144,10 @@ const feature: Feature = {
         by teams on the product. This way, no money is wasted, everyone has
         everytime something to do.
       </p>
+      <p>
+        But it comes with a cost: the more feature ongoing in parallel, the more
+        it is difficult to focus and it is more likely to introduce a defect..
+      </p>
       <h3>
         The pull system: produce features only when the next team needs it
       </h3>
@@ -181,16 +176,14 @@ const feature: Feature = {
     </div>
     <FlowDashboard class="above" />
     <FeatureSteps alias="playground" />
-    <SimulationControls type="single" class="above" />
+    <div class="manual-simulation text">
-    <SimulationDashboard />
-    <div class="flow-single-simulation text">
       <!-- TODO: Mettre ici le comportement en pull system et en push system.
      En push system, on voit un goulot d'étranglement.
      En pull system, on voit petit à petit du danse avec une passation de plus en plus facile.
      Il n'empêche que dans les deux systèmes il y ai de la création de défaut -->
       <p>
-        Not so obvious... So what can we learn? What are the patterns we can
+        So what do you think? Not so obvious... So what can we learn? What are
-        identify?
+        the patterns we can identify?
       </p>
       <p>
         In a primarly <PushSystemIcon /> push system, we see teams struggling
@@ -201,13 +194,20 @@ const feature: Feature = {
         In a primarly <PullSystemIcon /> pull system however, we see a smoother
         flow of work with teams able to pass on features more easily and
         continuously, leading to a more steady and predictable delivery. It's
-        not perfect, but you may have see a balai of features when teams work
+        not perfect, defects are still there. But when we start to see
-        and finish at the same time. 💃🏽
+        synchronisation, we can see a better quality too.
-        <!-- TODO complete this sentence -->
       </p>
       <p>
-        Before any conclusion, comparing two simulations is not enough. Let's be
+        Here are two buttons to simulate the same project with only one strategy
-        more scientific here and let's generate 200 projects delivering the 20
+        involved so we can compare.
+      </p>
+    </div>
+    <SimulationControls type="single" class="above" />
+    <SimulationDashboard />
+    <div class="text">
+      <p>
+        Pull systems seem better. But before any conclusion, comparing two
+        simulations is not enough. Let's generate 200 projects delivering the 20
         features of the Newsletter app and see what happens.
       </p>
     </div>
@@ -215,8 +215,11 @@ const feature: Feature = {
     <SimulationDashboard />
     <div class="flow-multiple-simulation text">
       <p>
-        Okay, now we're pretty sure! For a long time, I wanted a proof
+        Okay, now we're pretty sure! The takt time is quite close actually. But
-        <em>to trust the process</em>, that's the beauty of simulations. . It's
+        as the quality issue increase in the push system, these defects and
+        corrections pile up and generate at about 15 days of difference. For a
+        long time, I wanted a proof
+        <em>to trust the process</em>, that's the beauty of simulations. It's
         quite impossible to convince people when we're in the middle of the
         battle. If teams change every time, you are doomed to get this problem
         over and over again.
@@ -225,10 +228,11 @@ const feature: Feature = {
         Teams tend to underestimate how long a project will be. And how hard it
         will be to work with others.
       </p>
+      <!-- [dps]
       <p>
         Note that problem solving is always a good practice. The capacity of the
         team to stop and think about how they work is critical.
-      </p>
+      </p> -->
       <p>
         If we're not in a good pace, we just have to try harder. Only once.
         "Just in time" becomes "Just this time" many times. So teams
@@ -254,10 +258,10 @@ const feature: Feature = {
           target="_blank"
           rel="noopener noreferrer"
           href="https://journals.aps.org/pre/abstract/10.1103/PhysRevE.96.052303#:~:text=The%20%E2%80%9Cfaster%2Dis%2Dslower,evacuation%20time%20can%20be%20achieved"
-          >faster is slower</a
+          >slower is faster</a
         >
-        is counter-intuitive but it is a fact. The more we push the more we are
+        is counter-intuitive. The more we push the more we are slowing down the
-        slowing down the system.
+        system.
       </p>
       <p>
         When money and pressure are in the game, fear, uncertainty, and doubt
@@ -280,7 +284,7 @@ const feature: Feature = {
         This is the question of team work.
       </p>
     </div>
-  </div>
+  </article>
 </template>
 
 <style lang="scss">

src/modules/pull-system/feature/FeatureItem.vue

@@ -13,7 +13,9 @@ const hasQualityIssues = computed(() => props.feature.qualityIssue > 0)
 <template>
   <div class="feature-item bin" :class="{ live: isLive }">
     <div>
-      <span class="numeric">({{ feature.complexity }})</span> {{ feature.name }}
+      <!--  [complexity]
+      <span class="numeric">({{ feature.complexity }})</span> -->
+      {{ feature.name }}
     </div>
     <div class="numeric">
       {{ feature.leadTime }}d

src/modules/pull-system/feature/FlowDashboard.vue

@@ -56,10 +56,11 @@ const featureStore = useFeatureStore()
         Quality issues
         <div class="numeric">{{ featureStore.qualityIssues }}</div>
       </div>
+      <!-- [complexity]
       <div class="card">
         Mean complexity
         <div class="numeric">{{ featureStore.meanComplexity }}</div>
-      </div>
+      </div> -->
     </div>
     <FlowControls />
   </div>

src/modules/pull-system/simulation/SimulationDashboard.vue

@@ -53,12 +53,13 @@ const strategies: Strategy[] = ['push', 'pull']
             {{ simulationStore.meanQuality(strategy) }}
           </td>
         </tr>
+        <!-- [complexity]
         <tr>
           <td>Complexity</td>
           <td class="numeric" v-for="strategy in strategies" :key="strategy">
             {{ simulationStore.meanComplexity(strategy) }}
           </td>
-        </tr>
+        </tr> -->
         <!-- [dps]
         <tr>
           <td>Team work exp.</td>