Re: [Libreoffice] Script to find undocumented classes

> > Personally I think it would be very nice if source files had just a few
> > lines of comment telling what they are about, from a very high perspective.
> > Every time I am searching for the implementation of some functionality in
> > the OOo/LO codebase, I find myself looking at source files with vaguely
> > correct sounding file names (and vaguely correctly sounding class names
> > inside), but no clue if it actually is what I am looking for.
> >
> > (Yeah, now that we have forked off the codebase, I of course should take up
> > the habit of adding such a few comment lines every time I find out what the
> > code in some particular source file does, especially in cases where one can
> > easily be mislead and spend hours looking at irrelevant code before
> > realizing...)
>
>  I think that would be very helpful.

Totally agree.

Sometimes, after floundering around in the code for a while, I
suddenly come across a comment, and things get *so much* clearer, and
feel I find myself overcome with overwhelming gratitude towards the
mysterious comment writing person.

Even if it's short and cryptic. And in German. It helps that much.