Moin Dennis ( @dreischild ),
wir sind momentan schon dabei die Dokumentation anzupassen und haben für viele Szenarien mittlerweile Beispiel Plugins.
Ich habe dir hier mal ein Beispiel Plugin angehangen, welches nichts wirklich macht, aber vieles einmal anreißt. (Testing suite, Services, Controller, Subscriber, Plugin Config, …)
Das wird so in der Form mal in einem “Plugin quick start” Guide auftauchen - daher auch der Name. 
Hilft dir das erstmal weiter?
@Shopwareianer:
Ich nutze das Setup mit MacOS und habe damit absolut keine Probleme.
Tatsächlich konnte ich da auch grob den Ubuntu Guide nutzen - man muss halt nur wissen, wie das jeweilige MacOS Pendant heißt / funktioniert.
Den von dir beschriebenen Fehler habe ich “leider” nicht.
Ich hatte übrigens diesen Guide genutzt, um mehrere PHP Versionen auf meinem System zu installieren - wie hast du das denn gemacht?