Self-Documented Makefile
They should really be using bash for this, not make.  There is nothing wrong with bash scripts calling Make -- for building with DEPENDENCIES.  But when you aren&#x27;t doing that, just use bash (because Make is actually Make + bash to begin with).<p>This is dumb:<p><pre><code>    restart-frontend: ## Restart the frontend and admin apps in dev
       @make stop-frontend-dev &amp;&amp; make run-frontend-dev
       @echo &quot;Frontend app restarted&quot;
</code></pre>
Write it with a shell script like this:<p><pre><code>    stop-frontend-dev() {
       ...
    }

    run-frontend-dev() {
       ...
    }

    restart-front-end() {
      stop-frontend-dev
      run-frontend-dev
      echo &quot;Frontend app restarted&quot;
    }
  
    build() {
       make  # this actually does stuff you can&#x27;t do in bash.
    }

    &quot;$@&quot;  # call function $1 with args $2...  Can also print help here.
</code></pre>
This is a lot cleaner.  The PID stuff can be done with bash too.