Re: pod2.perl.org! (was Re: Perl core documentation translations)

On Mon, Oct 5, 2009 at 9:30 PM, Enrico Sorcinelli <
enrico.sorcinelli@gmail.com> wrote:

> Hi all,
>
> first of all, thanks for your feedback and suggestions!
> I'm very happy to announce that we have pod2.perl.org domain and
> pod2@perl.org maling list.
> Please, if you interested (and I hope of yes), subscribe it! :-). I
> haven't the grant to do that, so you have to send a mail to
> pod2-subscribe@perl.org. Then you can send a simple post just saying
> hi :-)
> The list archives will be available at http://www.nntp.perl.org/.
> Currently pod2.perl.org contains a temporary home page. The main site
> is under http://pod2.perl.org/wiki (MojoMojo powered). I hope also to
> discuss with you all webiste related things (such as contents,
> structure, documents and so on) into the mailing list.
>
> Status of worlwide translation projects
>
> - Chinese
> POD2::CN is currently stalled.
> Fayland, agree on use POD2::CN backpan package for pod2.perl.org (at
> least it will remind he to restart the translations :-)
> Fayland also agree on pod2.perl.org and he said me that he'll join to
> pod2@perl.org once it will be ready.
>
> - French
> POD2::FR is active (latest release on 03/04/2009).
> (however Paul, the project leader, didn't respond yet to me)
>
> - German
> Harald H.-J. Bongartz agrees on pod2.perl.org and he'll join to
> pod2@perl.org once it will be ready.
> POD2::DE doesn't not yet exist. However I sent to Harald the
> POD2-DE-0.01 package skeleton containing the 14 translated pods.
> I also contacted Joergen W. Lang (the author of interesting
> perldoc2.sourceforge.net project, but apparently out of date): he is
> quite busy now but he agrees on pod2 project and list.
>
> - Italian
> POD2::IT is active, of course :-) (latest release on 26/09/2009).
> Currently we are reviewing translated pods for 5.10.0/5.10.1
>
> - Japanese
> perldoc.jp is a big active project.
> However IWAI, Masaharu (the sourceforge project leader) didn't respond
> yet to me.
>
> - Lithuanian
> Petras Kudaras has been in charge of Lithuanian Perl documentation
> translations a while ago.
> He will try to contact Lithuanian Perl community and see if they are
> still interested in joining the project
>
> - Portuguese
> Solli Moreira Honorio (the sourceforge brazilian project leader)
> didn't respond yet to me.
> He translated to portuguese almost all 5.8.8 core pods!
> I also contacted José Castro in order to know if portuguese guys have
> similar projects.
>
> - Spanish
> Joaquin Ferrero and Enrique Nell agree on pod2.perl.org and they will
> join to pod2@perl.org once it will be ready.
> POD2::ES doesn't yet exist. However I sent to them the
> POD2-ES-0.01 package skeleton containing the 7 translated pods.
> Joaquin and Enrique organized a BOF during the recent YAPC::EU in
> Lisbon with the goal of relaunching the project. They also have a nice
> guidelines document about spanish translation project.
>
> - Turkish
> Burak Gürsoy abandoned the project (he report that unfortunately Perl
> is not popular in Turkey) but he agrees on pod2.perl.org
>
> Moreover there are other people involved into the project.
>
> Gabor Szabo agrees on pod2.perl.org and he'll join to pod2@perl.org
> once it will be ready.
> Also Gabor agrees to move it.perldoc.org and fr.perldoc.org
> translations under pod2.perl.org.
> He patched the code that runs perldoc.perl.org by adding support for
> multiple languages. I hope also that these improvements will be merged
> into main code (currenlty he forked a new project).
>
> I also contacted several times Adriano Ferreira (the current
> Pod::Perldoc maintainer) since the module have to cooperate with POD2
> packages.
> 5.10.1 Pod::Perldoc breaks POD2:: packages and also latest CPAN
> Pod::Perldoc contains several little bugs (I sent a patch to p5p
> list).
> Unfortunately he didn't respond yet to me :-\
>

I am listening. My basic point is that we need a base package like
POD2::Base which is optionally loaded by perldoc and not part of p5p core.

Why a base package? So we can sophisticate language support, with the
minimum fuss for Pod::Perldoc code which is rather clunky by now. Adding to
the top of it (without a plugin-like structure) won't make it better, but
instead harder to maintain and evolve.

Why not part of p5p core? Because p5p don't want or need more modules to
take care of. Look how CPAN.pm has a myriad of useful optional modules which
are not part of the core, and it still works.

Congratulations for your effort to create this front for the Perl
documentation translations.

Best,
Adriano



>
> Again, thanks you for your patience and sorry if I've bored you, but I
> hope to hear from you soon on pod2@perl.org mailing list!
>
> Cheers
>
>   - Enrico
>
>
> 2009/8/18 Enrico Sorcinelli <enrico.sorcinelli@gmail.com>:
> > Hi all,
> >
> > I wrote you since you are (or you seems to be) the local Perl core
> > documentation translation project owner (if I am using wrong email
> > addresses, please could you provide me
> > with an e-mail contact to whom I can ask instead?)
> >
> > A little bit of history.
> > Since 2002, Italian Perl users and I worked on italian Perl core
> > translations. The project is called pod2it (pod2it.sf.net). Of course,
> > similar projects started on other countries.
> > After translating several pods, we decided to package them into a Perl
> > package in order to better distribute.
> > So I wrote "POD2::*" RFC translation namespace,
> > (
> http://www.xray.mpe.mpg.de/mailing-lists/perl-documentation/2003-07/msg00015.html
> )
> > and I patched perldoc (available from 5.10.0), in order to integrate
> > it with POD2::* translations. For example:
> >
> >   %> perldoc -L it perldiag
> >
> > I also spoken about POD2 several times at Italian Perl Workshop (f.
> > e.:
> http://www.slideshare.net/bepi/pod2-and-perl-translation-documentation-project
> ).
> >
> > Currently, there are 10 translation projects (see attached image) some
> > of which are at the very early stage and others have a very lot of
> > pods! :-)
> > Not all projects use POD2 namespace however. I don't know if POD2 is
> > the best (or bad) format to distribute translated documentation, but
> > it is a practice and good starting point.
> >
> > But there isn't a really worldwide documentation project: I'm not
> > saying we shouldn't start a new project, but since volunteers are
> > already around, we should avoid duplicate efforts as much as possible.
> > So I agree on coordinating worldwide POD2 projects: we should write a
> > guidelines, we could share experience, resource and tools, unique
> > CVS/svn/git, dedicated mailing list(s), and so on.
> > Moreover I have in plan to ask pod2.perl.org for the official Perl
> > POD2 translations documentation site: the right place IMHO should be
> > under perl.org umbrella.
> > Currently Gabor Szabo maintains perldoc.org (with italian and french
> > POD2::* translations) but he agrees with pod2.perl.org.
> >
> > Yes I know, probably the better choice could be to improve
> > perldoc.perl.org by adding
> > translations, but about that there are open questions:
> > - Each POD2 package will have to be based on a unique Perl release
> > - Incomplete translations will not be included and of course will not
> > be available on the site
> > - Where to put not core pods translations (for example we translated
> > POD2::IT::Getopt::Long)
> >
> >
> > Comments/criticisms will be very appreciated! :-)
> >
> > Thanks in advance.
> >
> > Best
> >
> >  - Enrico
> >
>

• Re: pod2.perl.org! (was Re: Perl core documentation translations) by Adriano Ferreira
• Re: pod2.perl.org! (was Re: Perl core documentation translations) by Enrico Sorcinelli
• Re: pod2.perl.org! (was Re: Perl core documentation translations) by Adriano Ferreira