M. Dietrich schrieb:
nur: wo ist das dokumentiert? die
callbacks sind alle aufgezaehlt, dies verhalten hab ich nicht
gefunden. auch nicht, welcher callback wann aufgerufen wird - so
ein flow waere schoen.

Naja, bei den meisten Callbacks ist das schon aus deren Namen
ersichtlich...

Ansonsten gebe ich gerne zu, dass unsere API-Doc noch
nicht vollstaendig ist. Ich nehme solche Anregungen gerne auf, damit
andere Programmierer einen leichteren Einstieg bekommen.

gern, reicht dies als anregung oder braucht ihr mehr?

Wir brauchen mehr. Also wenn du bei konkreten Funktionen die Doku unvollständig findest oder Fragen hast, dann empfehle ich, dass du direkt im header herumeditierst und uns das diff schickst ("/** DOCUMENTME: What does the return value mean? */"). Wir sehen dann zu, dass offene Fragen beantwortet und durch Erklärungen ergänzt werden. Bzgl. allgemeine Dokumentation: Schreib doch mal auf, wie du die Herangehensweise nun verstehst bzw. wie du das anderen empfehlen würdest und schick das ebenfalls. Das könnte dann als Text ins doc/ Verzeichnis gehen, nachdem wir das korrekturgelesen haben und ergänzt haben. Und wenn du irgendwelche sequence diagrams zeichnen könntest, würden wir die auch sofort gerne mit ins CVS übernehmen...

Christian


-------------------------------------------------------
This SF.net email is sponsored by: Splunk Inc. Do you grep through log files
for problems?  Stop!  Download the new AJAX search engine that makes
searching your log files as easy as surfing the  web.  DOWNLOAD SPLUNK!
http://sel.as-us.falkag.net/sel?cmd=lnk&kid3432&bid#0486&dat1642
_______________________________________________
Aqbanking-devel mailing list
[email protected]
https://lists.sourceforge.net/lists/listinfo/aqbanking-devel

Reply via email to