Hello Steffen,
sieht ja erstmal ganz nett aus 
Vor allem, dass es eindeutige Funktionsnamen gibt. Allerdings, kann ich Dir nur empfehlen von dem Prefix "brutal_cache_XY_fn" auf was kürzeres umzusteigen, zB "bcp_XY_fn", weil man sonst recht komisch wird beim Schreiben und lesen (Die Namen auf Dauer schauen sonst alle gleich aus).
Einen Link den ich bzgl. Plugin-/Themeentwicklung gerne weitergebe: http://wordpress.stackexchange.com/questions/715/
Was ich selbst vom entwickeln gelernt habe: So ausführlich wie möglich dokumentieren. Der PhpDoc-Standard hat sich da als gute Hilfe erwiesen und wird auch von IDEs wie Firephp oder Eclipse unterstüzt. Ich mach's immer so:
[COLOR=SeaGreen]/**
* Titel der Funktion
*
* Beschreibung
* How-To
* @param $my_var Parameter, den die Funktion aufnimmt
* @since Brutal Cache v0.3.4
* @used wp_die() @link http://wordpress.org/doc/etc...
*/[/COLOR]
if(!function_exists('bcp_xy_fn_name')) {
function bcp_xy_fn_name($my_first_var = null, $my_second_var) {
[COLOR=SeaGreen]// Kommentar um die Variable 1 zu beschreiben[/COLOR]
$my_first_var = array();
[COLOR=SeaGreen]// Kommentar um die Variable 2 zu beschreiben[/COLOR]
$my_second_var = 'Test';
[COLOR=SeaGreen]# @todo: Testen, ob $my_first_var is_array() && !empty[/COLOR]
[COLOR=SeaGreen]// Kommentar um zu beschreiben, was hier passieren soll[/COLOR]
foreach($my_first_var as $first_var) {
[COLOR=SeaGreen]// Beschreibung nächster Schritt[/COLOR]
[COLOR=SeaGreen]# @magic Falls etwas nicht stimmt, nächste Zeile zur Kontrolle entkommentieren:
# echo 'Erstes Element des Arrays: ' . $first_var;[/COLOR]
USW.
} [COLOR=SeaGreen]// end foreach;[/COLOR]
}
}
Alles anzeigen
Wie Du siehst, kommentiere ich recht exzessiv. Hat sich aber oftmals bewehrt, weil Du in einem Monat oder schon einer Woche nicht mehr weißt, warum Du was gemacht hast. Ich verwende immer diese 3 Arten des Kommentars für unterschiedliche Dinge: Mehrzeilig für Dateieinleitungen, Class- und function-Beschreibungen; // einzeilig um den Fortschritt und das gewünschte Ergebnis zu kommentieren; # einzeilig um echo, print, var_dump auszukommentieren. So kann ich schnell nachschauen, ob irgendwo das richtige oder falsche Ergebnis raus kommt. Weiters in Kombination mit todo, weil ich meine todo-Tasks so auch in Notepad++ mit einer Dateiübergreifenden Suche sofort finde. Nie lange an einem Problem bleiben, lieber ein todo schreiben und weiter kommen.
Ein anderer guter Tip ist auch, den Schreibstil beibehalten.
[COLOR=SeaGreen]// einmal so:[/COLOR]
echo "Das ist ein ".$test;
[COLOR=SeaGreen]// und einmal so:[/COLOR]
echo 'Das ist ein ' . $test;
[COLOR=SeaGreen]// ist nicht gut, weil Du Dir beim Lesen auf Dauer schwer tust[/COLOR]
Wichtig finde ich auch die Überprüfung von Existenzen, etc.. : file_exists, is_file, !empty, is_array(, !function_exists, !class_exists, usw. Damit ersparst Du Dir einen Haufen Ärger. Ich hab so meine Error-function, die __FILE__ mit aufnehmen kann, damit ich dann eine vernünftige Fehlermeldung bekomme und nicht bei jedem Update immer alles durchsuchen muss, ob es so eh noch existiert.
Gutes Gelingen! (Ich abonnier den Thread mal).