[Dune] Dune Doku

[Adrian Burri]

robertk wrote:

> Oliver Sander wrote:
>
>> Zumindest für den Heap steht da 'MegaBytes'.  Für den EnvHeap (wo
>> sowieso keiner weiß was es ist) habe ich es zugestandenermaßen
>> vergessen. ;-)
>>
>> Wo wir gerade bei Dokumentation sind:  Mit der neuen Gitterschnitt-
>> stelle sieht man ja keine Klassen einer Gitterimplementierung mehr,
>> außer dem eigentlichen Gitter.  Alles andere ist ja generisch.
>> Deswegen finde ich sollte man die Gitterimplementierung bis auf
>> die Hauptklasse aus Doxygen rausnehmen.  Dadurch würde die Online-
>> Dokumentation ein kleines bißchen übersichtlicher.  Was hälst
>> Du davon?
>
> Das sehe ich absolut genauso. Adrian ist das allerdings anderer 
> Meinung. Am besten wäre es, wenn man eine offizielle Doku hätte (ohne 
> Implementierungen) und dann eine interne für Proger, die halt auch mal 
> mehr wissen möchten. Aber so wie es im Momnet ist, finde ich das Chaos 
> einfach zu gross. Man weiss überhaupt nicht mehr wo vorne und hinten 
> ist. Man könnte das denke ich so machen, dass die offizielle Doku über 
> Netz erreichbar ist (wir müssen auch auf unser Auftreten nach aussen 
> achten) und die interne von jedem selbst generiert werden, mit einem 
> Zusatz parameter oder so was, ich kenne mich bei doxygen da nicht so 
> aus, würde aber erwarten, dass das geht.
>
> Wie sehen die anderen die Sache?
>
> Gr
>
> R
>
> _______________________________________________
> Dune mailing list
> Dune at hal.iwr.uni-heidelberg.de
> http://hal.iwr.uni-heidelberg.de/cgi-bin/mailman/listinfo/dune

Hallo,

ich denke, mein Standpunkt ist bekannt: Ich benutze die Doxygen-Doku bei 
meiner Arbeit und als Entwickler moechte ich auch gerne alles sehen. 
Gegen eine abgespeckte Version fuers Netz habe ich nichts einzuwenden, 
allerdings weiss ich selber z.Zt. nicht, wie das in Doxygen zu 
bewerkstelligen ist und wieviel Aufwand dazugehoert.

Gruss Adi