Re: Document writer credits in About boxes

[Chee Bin HOH <cbhoh yahoo com>]

--- Breda McColgan <Breda McColgan Sun COM> wrote:
> Hi Malcolm,
> 
> is this something that the writer should do, or
> something that the writer
> should ask the developer to do?

Maybe it can be done by document maintainer, jfleck
mentioned before maintainers
deal with all the other crap that needs to be taken
care of - docs
builds and the like. while writers write docs.

that is what shown in doctable, ;)

> 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
> ?z&yÚ?+-?¨¥?x%?Ë`???v?%?Ë`???¢¸!¶Úþf¢?
è?ê+?ù??Y??ùb²Ø§~?à???v?%?Ë


=====
Chee Bin HOH <cbhoh gnome org>

Where we're going, we don't need roads..., http://www.gnome.org

Free Software - `Free` as in Freedom, http://www.gnu.org/philosophy/philosophy.html

Please avoid sending me Word or PowerPoint attachments.
See http://www.fsf.org/philosophy/no-word-attachments.html

__________________________________
Do you Yahoo!?
Yahoo! Hotjobs: Enter the "Signing Bonus" Sweepstakes
http://hotjobs.sweepstakes.yahoo.com/signingbonus