arc42 - Version 7

(for DE see below)

English Version

Finally, after extensive discussions with users and our committers we released a new version of arc42. Fully compatible with prior versions, preserving the established template structure, v7 has become even more pragmatic and compact. That makes using the new version simpler and more efficient than ever before. For v7 we vastly improved documentation and explanation of arc42 - creating two extensive sites (docs.arc42.org and faq.arc42.org). For a more detailed intro, see this post on the innoQ blog.

Deutsche Version:

Endlich, nach langer Diskussion mit Nutzern und Comittern haben wir eine neue Version von arc42 veröffentlicht. V7 ist vollständig kompatibel mit früheren Versionen. Wir haben die bewährte Struktur komplett erhalten, sämtliche Erklärungen und Hilfetexte jedoch gründlich überarbeitet und noch pragmatischer und einfacher gestaltet. Die Nutzung dieser neuen Version wird damit noch einfacher, als das bisher war. Insbesondere gibt es nun zwei umfangreiche Websites mit praktischer Hilfestellung ((docs.arc42.org and faq.arc42.org). Mehr Infos in diesem Post (im innoQ Blog).

Praktische Tipps für arc42

arc42 hat sich als de-facto Standard für die Dokumentation von Softwarearchitekturen etabliert, zumindest in der D-A-CH Region. Schon länger gab es online diverse Beispiele, seit März diesen Jahres habe ich gemeinsam mit Michael Simons und Stefan Zörner dazu ein eBook veröffentlicht (als LeserIn dieses Blogs erhalten Sie bis Ende 2016 ganze 42% Rabatt!).

...in Aktion

Aber DAS wollte ich hier gar nicht in den Fokus rücken - vielmehr sollen konkrete Tipps zur Anwendung von arc42 zur Sprache kommen: Schon seit Jahren unterstütze ich Unternehmen unterschiedlicher Branchen und Größen beim Einsatz von arc42 in Entwicklungs- und Wartungsprojekten. Dabei konnte ich eine Vielzahl von Tipps und Ratschlägen sammeln - die nun endlich mal in gesammelter Form (als Buch) verfügbar sind. Peter Hruschka hat aus seiner vielfältigen Erfahrung, häufig aus Embedded und RealTime Umfeldern, kräftig beigesteuert, so dass wir auf insgesamt 200 Tipps rund um den Einsatz von arc42 gekommen sind. Ob es um arc42 in agilen Umfeldern geht, oder um die Anwendung in besonders großen (oder besonders kleinen) Systemen - stets liegt der Fokus auf praktischer Anwendbarkeit und Angemessenheit.

... Advent kommt bestimmt

Auf arc42 veranstalten wir ja regelmässig Aktionen, bei denen wir unseren LeserInnen kleine Geschenke versprechen. So viel sei hier verraten: Die Advents-Aktion 2016 hat etwas mit diesen Tipps und dem obigen Literaturhinweis zu tun... Es lohnt sich daher, gegen Jahresende ab-und-zu mal auf der Website vorbei zu schauen (oder dem noch jungen arc42-Twitter Account zu folgen).

one last thing

Übrigens schreibt gerade auch Ralf Müller (einer der Committer bei arc42 und langjähriger Nutzer!) ebenfalls gerade ganz aktiv einen Blog zum praktischen Einsatz von arc42.

Open-Close-Principle considered (practically) useless

Underlying Goal Considered Valuable

In a recent blogpost, the honorable Uncle Bob once again discussed the merits of the famous Open-Close-Principle. Quote:

You should be able to extend the behavior of a system without having to modify that system.

I like and strongly support that idea. It's realization by plugin-architectures is useful in some cases, it's foundation in object-orientation is one of the few useful applications of inheritance. I teach the OCP in classes and advice people inhale it like oxygen in their daily life. It's a beautiful theoretical concept. In practice, it's mostly useless - sigh.

The Nature of Changes in Practice

Since more than 20 years I work with teams changing, enhancing or optimizing software systems. I've seen code in financial industry, insurance and banking systems, logistics, telecommunications, embedded systems and, of course, the web. Changes were often corrections to previous requirements: (I quote real customers and product-managers in the following lines)

• "aargh - we didn't mean it THAT way, please correct it to THIS way".
• "Make it faster, whatever it takes."
)
• "We need some new attributes in the view"
• "You have to integrate the XYZ system urgently into our processing" (replace XYZ by SAP(c), Oracle(c) or any huge commercial software suite that you cannot integrate by just calling a simple API)

Too bad those requirements cannot be met by simply creating a new plugin to a nice-and-beautiful plugin architecture. Too bad those requirements often invalidate yesterdays' assumptions and code. The open-close-principle does not help me in those cases. Those cases are the rule, the standard, normal. Even if I (or other software engineers) had implemented plugin architectures - those wouldn't help with new attributes in some strange old-school UI or some backend insurance database.

Is Open-Close Applied in Real Systems?

Most productive systems I met (and I met many many dozens of them) don't have the notion of clear extension points. Many have been implemented by teams under severe cost or time restrictions without freedom to apply design principles - sigh again. That's one reason we founded aim42 - to systematically improve (and hopefully help spread OCP application..). @Uncle Bob: Thanx for your design principles - they make this (software) world a better place...

Patterns-kompakt, die Vierte...

Gerade frisch aus der Druckerpresse kommt die vierte Auflage von Patterns-kompakt, der kurzen und hoffentlich kurzweiligen Einführung in Entwurfsmuster.

Das Buch fasst die wichtigsten Entwurfsmuster zusammen, die Sie für Software-Entwicklung benötigen. Software-Entwickler, -Architekten und -Designer finden darin effektiv anwendbare Lösungen für tägliche Entwurfsprobleme. 

Neu zur vierten Auflage sind jede Menge Codebeispiele, die zum Experimentieren mit den Mustern einladen… siehe hier.

Mehr zum Inhalt, viele Extrakte und jede Menge zugehörigen Sourcecode finden Sie auf der Website zum Buch… (danke an Karl Eilebrecht, dem PK-Helden!)

 

Rein aus historischen Gründen hier mal die Evolution der Cover (links mit der ersten Auflage beginnend) - wobei wir uns für das Aussehen der ersten Auflage ja fast bei unseren Lesern entschuldigen müssen :-)

  

 

Übrigens hat auch der Verlag eine Evolution hinter sich - von Spektrum über Spektrum-Elsevier zu Springer zu Springer-Vieweg…. 

(unabhängiger) Artikel über arc42-Einsatz

In der dotnetPRO erschien vor einiger Zeit "Nie wieder planlos" - ein ausführlicher Überblick zum arc42-Template und dessen Einsatz in der Praxis - aus der Feder von André Krämer.

 

Seit heute ist dieser kostenfrei als download erhältlich - dank einer Sondergenehmigung der dotnetPRO-Crew :-)

 

 

pragmatic Enterprise-Architect(™) template for arc42

I just released a slender version of the arc42 template in Enterprise-Architect(™) format.

Deliberately the template contains only four packages, although the full arc42 template contains several others:

Use it to model (construct, design or document) all structural aspects of your system, and use any other (text-oriented) tool for non-graphical information.

As with all arc42 artifacts, the template is absolutely free to use, no hidden fees or restrictions. It'd be nice though if you mentioned arc42...

Download

Download the template (with a very brief documentation) here.

Documentation

Even newcomers to Enterprise-Architect will be able to use the template within EA - nevertheless we provide a brief documentation for it within the arc42-confluence.

Restrictions

The template does contain a report generator, therefore it is currently not suited for complete software or system architecture documentation - just for the graphical information.

Disclaimer:

You are allowed to use this template in all situations you like – but we do not provide any (ANY!) kind of guarantee for it. It might crash your EA, or inflict your mind – we cannot possibly exclude such incidents. So please give us feedback, but please don’t blame us for any issues with EA, the template or your project.

Thanx

Thanx to my colleagues from innoQ Deutschland for supporting this work, thanx to Axel-N for productive discussion about modeling in general and especially applying EA.

Camp mit zwei Trainern

Vorsicht: Der nachfolgende Post enthält einen (kleinen) Anteil Eigenwerbung:

Für 2013 bieten mein geschätzter innoQ-Kollege Phillip Ghadir und ich einige interaktive Schulungen (a.k.a. Camps) zu Softwarearchitektur an, bei denen wir gleichzeitig unterrichten: Über die gesamten vier Tage werden wir beide immer dabeisein - um dem jeweils Anderen scham- und schonungslos ins Wort zu fallen und dessen Ausführungen durch unsere eigene Erfahrung zu ergänzen, abzurunden oder zu kontrastieren.

Wir sind der Meinung, dass die "War Stories", also die (anonymisierten) Berichte aus realen Projekten die wahre Würze der Schulungssuppe ausmachen - und dass wir wesentlichen Lerneffekt besser durch Beispiele denn durch theoretische Konzepte erreichen. Solche realen Erfahrungen können wir zu zweit intensiver und vielseitiger vermitteln, als das ein einzelner Trainer alleine vermag!

Für uns (und die Entwickler-Akademie als Veranstalter) bedeuten zwei Trainer erheblichen Mehraufwand - Koordination, Abstimmung, Vereinheitlichung der Unterlagen und so weiter... All das nehmen wir aber gerne in Kauf, weil wir (Phillip und ich) fundamental von dem Konzept "Ein Camp, zwei Trainer" überzeugt sind!

Vom 19.-22. Februar finden Sie uns in München, im Mai dann in Berlin. Sie können im Anschluss die iSAQB e.V. Zertifizierungsprüfung zum "Certified Professional for Software Architecture - Foundation Level" ablegen. Dafür (und noch wichtiger, für Ihr weiteres Leben als Softwarearchitekt) machen wir Sie fit - versprochen!



Apropos - das Konzept verfolgen Peter Hruschka und ich mit den arc42-Workshops "Mastering Software Architectures" schon seit einigen Jahren mit großem Erfolg.
















Update (nach dem Workshop) - einige Stimmen von Teilnehmern, aus Kommentaren
in Phillip Ghadir's Blog.

Architektur auf Tour

Ich bin sehr froh, bei der kleinen, aber feinen Jax-on-Tour 2012 mitwirken zu dürfen.
Die Veranstalter hat einen guten Themenmix und klasse Sprecher zusammengestellt, unter anderem Ted Neward, Stefan Tilkov, Wolfgang Keller, Phillip Ghadir und Matthias Bohlen… Erwarten Sie geballte Erfahrung und spannende Vorträge.

Disclaimer: Ich spreche auch…

Major Update von "Patterns kompakt"

Karl Eilebrecht hat mit heldenhaftem Einsatz unsere Website von "Patterns-kompakt" erweitert und grundsätzlich überarbeitet - sie lohnt einen Blick!

Apple-TV: Set Favorite Radio Stations...

To set any internet radio station as favorite, just press the middle-button for a few seconds (see image below) while this station is playing... and a menu appears!

On the iPad Remote app it's even simpler - in the lower left corner you find a "favorite" button...

Macht Dueck zum Kanzler - endlich!

Warum hat kaum ein Politiker oder Politikerin nur halb so viel Verstand und gute Ideen wie Gunther Dueck - Chief Scientist von IBM...

Er bringt unser Bildungsdilemma (oder soll ich -desaster schreiben?) auf den Punkt - her mit der Könnens-Gesellschaft und freiem Internet - mit Steinkohle und Auswendiglernen können unsere Kinder nichts mehr werden in der modernen Welt.

Schauen Sie mal rein - seine tolle Rede auf der re:publica. bei YouTube.

Find Stencils in OmniGraffle!

Did you note the cool new stencil-search in OmniGraffle 5:

Instead of restricting the search to the locally installed stencils, you can now search Graffletopia, the online stencil-collection.

Imho another proof that the OmniGuys are more than mere mortals!

Thanx, OmniGroup!

Math on Macs as it should be...

great idea - implement a calculator without those ugly buttons:

Soulver!

I bought the iPhone version - best calculating experience
since the old HP RPN times. Enter your queries in the left pane,
immediately see your results on the right.

UI designers - take a deep breath and a good look! Just in case you care: Mac OS only.



Update (March 25th): The guys from SpeedCrunch notified me of their
(free and open source) alternative, running on a plethora of platforms (aah, it's Qt).

Thanx, I'm impressed. It makes me double my effort to find myself some free time to fiddle around with Qt...

Readable websites - no ads, no junk

The German magazin "Die Zeit" featured a very useful bookmarklet
in their March 4th edition, from lab.arc90.com, called "readability".

Try for yourself - works like a charm!

Watch the 1:13min video...

(btw: it's open source, code available here)

[OOP 2010] Und wieder: IT'ler lernen kommunizieren...

Wie bereits im vergangenen Jahr findet auch auf der OOP 2010 wieder mal
ein echtes Highlight für die Kommunikationsfähigkeit von IT'lern statt:

Alice Heiliger, Rody Shaw und Andreas Goerlich präsentieren ihren
ganztägigen Workshop:

Wie dirigiere ich (m)ein Team?

Am Montag den 25. Januar erleben, lernen und üben Sie dabei Teamdynamik und Führung "live". Die Trainer arbeiten mit professionellen Musikern, und Sie schlüpfen in die Dirigentenrolle.

Aus dieser Analogie (Dirigent = Team-/Projektleiter) leiten die drei
wertvolle und zeitlose Tipps und Praktiken für den täglichen Umgang
von Menschen miteinander ab - interessant, spannend und für uns IT'ler
sehr nützlich.

Ich durfte diesen Workshop in einer Kurzform im letzten Jahr genießen - und möchte ihn wirklich weiterempfehlen!!

See Climate Change happening...

On the great TED conference, I saw this video on retreating ice glaciers... what are we humans doing to Mother Earth?

The photographer, James Balog, has been working for ExtremeIceSurvey. Seeing is believing...



Very impressive, well worth watching.

I stopped using Eclipse...

Ever had hassle with your numerous Eclipse plugins? With update-manager complaining about missing dependencies, which nobody ever could resolve?

With re-installing your (free) development environment every now and then?

After giving the latest Eclipse ("Galileo") a try, I just dumped it: After configuring Spring, Scala, webservice, subversion and a few other plugins, the whole app did not even bother to start...

Having been Eclipse user for several years, I am really grateful for their contribution to (Java) software development. But it has become an overly complex monster in my (humble) opinion.

I lighthearted moved over to IntelliJ-IDEA - their slogan "develop with pleasure" became true within the first hour of using IDEA (I tried both 8.1.3 and their early-access version 9). Grails and Groovy support is excellent, Scala plugin working fine, subversion support the best I ever had, even Clojure working (ok - that one can definitely be improved, but true lisp programmers should stick to Emacs)

Proud user of

die "Vierte"...

Gestern ist bei Hanser die vierte Auflage meines Buches "Effektive Software-Architekturen" erschienen. Die aktuelle Version hat um 30 Seiten auf 435 Seiten zugelegt.

Darin finden Sie jetzt über 50 Seiten Beispielarchitekturen (ich beschreibe ein System zur Datenmigration und eine CRM-Produktfamilie, beides real existierende Systeme). Dieses Kapitel können Sie beim Verlag kostenfrei herunterladen, als Appetithappen...

In einem weiteren neuen Kapitel erläutere ich den standardisierten Lehrplan für Software-Architekten des ISAQB in Kurzform.

Weitere Neuerungen finden sich under-the-cover. In praktisch allen Kapiteln habe ich aufgeräumt, korrigiert und aktualisiert.

Falls Ihnen Fehler, Versäumnisse oder Ungereimtheiten auffallen, freue ich mich über Ihre Rückmeldung!

Vitamin-D...

My favorite technical podcast, Security Now by Steve Gibson, recently had an episode titled Vitamin-D.

At first I expected a story on some clever new computer virus or one of his precise wrapups of some-clever-new-technology.

But this time Steve went for something completely different: Health. Human health - which is something most of us should be concerned about.

He presented some interesting research results about vitamin-D, showing a significant correlation between Vitamin-D levels and health. His short summary - which he proves : Vitamin D promotes health.

I followed a few of his links, bought and read a (German) book - and now
I'm pretty convinced Steve has a point!

Architecture Evaluation with ATAM

I recently conducted several short software architecture evaluations (a.k.a. assessments) according to ATAM with small teams.

Once again I was positively impressed with the outcome: Within hours (literally!) we matched current quality goals to architectural approaches,
identifiying risks and non-risks... without even starting any tool...

So - just in case you need an overview of your architectural risks - go
and learn ATAM (for German readers: there's a free pdf on my website)

Give yourself (or your team) at least a day for an extensive evaluation -
half of which you will need to brainstorm and investigate your stakeholders' current quality goals.