Document writer credits in About boxes



During a talk / demonstration about GNOME that I was giving yesterday, I
was showing off how the standard About box shows translator credits in
each locale that has translation. Of course, I then wanted to show that
we credit documenters as well.

Unfortunately, we don't do that quite as well as we could. Part of the
reason is that translator credits happen automatically (they translate a
special string and the code puts it into the appropriate tab in the
dialog box). Documenter credits need to be manually inserted into the
source code by the maintainer. For the time being, we cannot easily
change the latter item (API compatibility), but it is something to think
about moving forwards.

However, for GNOME 2.6, we should make an effort to go through every
single application that has documentation and if all of the people who
have contributed significantly to an application's documentation are not
in the About box, send a patch to that maintainer (or at least a list of
who should be in the box; it is an easy change in the source to fix
this).

At the moment, documentation writers are not getting the credit they
deserve. This is unprofessional of us and we should fix it.

Cheers,
Malcolm



[Date Prev][Date Next]   [Thread Prev][Thread Next]   [Thread Index] [Date Index] [Author Index]