Donnerstag, 30. Juni 2011

Sitecore hat ein dokumentations Problem

Seit 2007 verwende ich Sitecore nun schon beruflich... was Sitecore ist? Also im klassischen Sinne ist es ein CMS - ein Content Management System - also eine Software die es mir erlaubt Webseiten zu erstellen und diese zu verwalten... (einfach gesagt :-)

Sitecore ist etwas komplexer als eine einfache Software, die es einem erlaubt Webseiten zu erstellen und im Internet anzuzeigen - Sitecore ist ein Framework - also eine Entwicklungsplattform die man nach seinen Wünschen programmieren und die alle möglichen Dinge anzeigen und verwalten kann - es ist in alle Richtungen erweiterbar, sehr flexibel und offen für jede Art von Programmierung.

Klingt doch super, oder?

Ja, für einen Web-Entwickler oder Techniker, der alle Möglichkeiten dieser Welt haben möchte um seine Lösung so zu gestalten wie er (oder meistens sein Auftraggeber :-) es haben möchte, ist das ein Traum.... oder doch ein Albtraum?

Dann nämlich wenn du zwar alle Möglichkeiten hättest, aber nicht weißt wie du sie umsetzen und ausnutzen kannst.

Mich jetzt bitte nicht falsch zu verstehen: Sitecore ist cool... aber...

Zu schnell gewachsen hat sich dort anscheinend keiner wirklich die Mühe gemacht die eigene API (Application Programming Interface - also die Schnittstelle mit der man all die tollen Möglichkeiten programmieren könnte...) zu dokumentieren. Es gibt nix klar oder vielleicht sogar gut dokumentiertes....

Zwar findet man massenweise Info Folder die Unglaubliches versprechen - aber keine Information wie ich dieses Unglaubliche auch erreichen kann.

OK, stimmt nicht ganz, denn...

...na klar, wir haben ein SDN - ein Developer Network - mit vielen Artikeln, vielen How-Tos - aber genau so vielen unzusammenhängenden und reichlich veralteten, sowie unkoordinierten Infos... die mehr frustrieren als sie helfen...

...und ja, zum Glück gibt es viele Freaks die ihr eigenes Blog schreiben und dort ihr Wissen preis geben - manchmal wirklich kompetent - manchmal leider nur Halbwissen oder zumindest nicht offiziell, das einem mehr Zeit kostet als es bringt...

...oh, und nicht zu vergessen ein Forum gibt es auch noch - mit reichlich schlechter Such Funktion und den gleichen, oft leider unzureichenden Ergüssen wie in den Blogs...

So sucht man oft tagelang nach einem kleinen Problem - erhält 25 verschiedene Lösungsansätze von denen 23 unbrauchbar sind und 2 zwar in die richtige Richtung gehen aber dann doch nicht alles abdecken - bis man dann in einem Kommentar zu einem Blog (eines der Kategorie 'die 2 die in die richtige Richtung gehen') der entscheidende Hinweis steht - ala 'hey, ich kann mich doch erinnern da gab's ein Problem... hmmm, ich glaube da muss man das und das machen... vielleicht...'.

Das ist kein Märchen - das ist uns gerade beim Upgrade von Version 5.3 auf 6.2 passiert - und genau in so einer Situation fragt man sich dann warum man (oder in meinem Fall meine Firma) solche Unmengen an Geld an Sitecore überweisen muss um es verwenden zu dürfen und außerdem Jahr für Jahr ordentlich 'Wartung' bezahlen darf..... wenn die offensichtlichsten Dinge nicht dokumentiert sind?


Liebe Freunde bei Sitecore - euer Produkt ist spitze, ohne Zweifel - zu recht rennen euch die Firmen momentan die Türe ein und eure Firma wächst praktisch unkontrolliert... alles super - aber lasst es mal ein bisschen bleiben mit dem 'neue Features' entwickeln, und dokumentiert (und das bitte sauber, richtig und übersichtlich) endlich mal die bestehenden!
Zumindest eine ordentliche Dokumentation eurer API wäre ein muss! Ist aber schlicht nicht vorhanden! Das sind Basics, das gehört einfach dazu! Reißt euch endlich am Riemen!

Und wenn ihr nicht wisst wie eine gute API Dokumentation und gute How-Tos und ein gutes Forum und gute Hilfe Artikel aussehen, schaut euch mal bei Telerik um... aber das ist eine andere, positivere Geschichte :-)