Re: Document writer credits in About boxes

[Breda McColgan <Breda McColgan Sun COM>]

Hi Malcolm,

is this something that the writer should do, or something that the writer
should ask the developer to do?

If the former, will you please post the relevant instructions to this list?
Thanks!
Sounds like information that should be included in the GDP Handbook too?

If the latter, perhaps you should forward your mail to the developer lists?



Thanks,
Breda.



Malcolm Tredinnick wrote:

> 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
> _______________________________________________
> gnome-doc-list mailing list
> gnome-doc-list gnome org
> http://mail.gnome.org/mailman/listinfo/gnome-doc-list