ich habe vor, eine kleine Diskussion zu starten
Wie steht ihr hinsichtlicher der Dokumentation dazu, wenn es in einem Projekt Methoden und/oder Funktionen gibt, die Implementierungsdetails sind? Sollten sie überhaupt dokumentiert werden oder gar nicht? Wenn ja, wer darf sie sehen? Und wie haltet ihr es mit großen, roten Boxen, die davor warnen, sie zu benutzen? Bringt das alles nichts, weil sie ja doch benutzt werden egal wie stark gewarnt wird? Womit wir wieder bei der ersten Frage sind: Sollte man die Doku dazu lieber gar nicht schreiben oder zumindest nicht publizieren, um zu verhindern, dass Benutzer solche internen Funktionen oder Methoden aufrufen? Habt ihr vielleicht Erfahrung oder allgemeine Richtlinien, die ihr teilen könnt?So, das waren meine Fragen. Ich kann keine von diesen sicher beantworten und bin gespannt, wie sich das hier entwicklen wird.
