Ich würde eigentlich auch denken, dass doch eine gute Dokumentation der entscheidene Aspekt für eine Schnittstelle sein muss. Wenn ich bei einer Variablen darauf hinweise, dass man diese möglichst nicht von extern nutzen sollte, reicht das doch vollkommen aus. Wo ist der Zusatznutzen, wenn ich so etwas wie privat davor schreibe? Nur dass mich der Compiler ggf. warnt und meckert und ich daraus implizit schließen muss, dass das nicht erwünscht ist? Da finde ich eine explizite Aussage in der Doku doch hilfreicher... nicht jeder steht auf "trial and error"
