Developers of Sympa

[IKEDA Soji <address@concealed>]

Hi,

On Wed, 21 Nov 2012 12:11:12 +0100
David Verdin <address@concealed> wrote:

> Hi Guillaume,
> 
> Étienne and I are quite found of this version. Call us lazy, but we 
> think we'll be more inclined to keep the pod up to date if it is just at 
> the top of the function.
> But there are four of us. Let Soji give his advice about the question.

I prefer to PODs on each top of functions.  It will make the
refactoring easy.  Full documentation may be extraced from
sources anytime it is needed.

I suppose perlpodstyle man page would be useful.

<<snip>>

> Something else. In order to officialize your contribution to the 
> project, I modified the Authors page of the Sympa web site: 
> https://www.sympa.org/users/authors

# Ah... It is honor to me to be listed in Sympa authors, but,
# I'd like to be treated equally to other noteworthy authors...

<<snip>>

Regards,

--- Soji

> cheers,
> 
> David
> 
> Le 20/11/12 19:29, Guillaume Rousse a écrit :
> > Le 19/11/2012 18:01, Guillaume Rousse a écrit :
> >> I have a personal preference for the second format, but I'll happily
> >> revert to the first one if there is a no consensus here :)
> > To make my explanations about pro/cons of both usage a bit more 
> > explicit, I just finished to reformat Sympa::OAuth::* and 
> > Sympa::VOOT::* modules using in-place documentation.
> >
> > Feel free to make your mind, and give me your preferences.
>