[PerlWikiBot] SF.net SVN: perlwikibot:[44] trunk/no-interwiki/prepare_noiw_list.pl

[<am...@us...>]

Revision: 44
          http://perlwikibot.svn.sourceforge.net/perlwikibot/?rev=44&view=rev
Author:   amire80
Date:     2008-07-28 16:47:22 +0000 (Mon, 28 Jul 2008)

Log Message:
-----------
Updated POD.

Modified Paths:
--------------
    trunk/no-interwiki/prepare_noiw_list.pl

Modified: trunk/no-interwiki/prepare_noiw_list.pl
===================================================================
--- trunk/no-interwiki/prepare_noiw_list.pl	2008-07-28 16:26:20 UTC (rev 43)
+++ trunk/no-interwiki/prepare_noiw_list.pl	2008-07-28 16:47:22 UTC (rev 44)
@@ -1396,43 +1396,68 @@
 Please report all bugs, features requests and other comments to
 Amir E. Aharoni (ami...@gm...).
 
-=head2 English is king
+=head2 There's no equality between languages
 
-In the meantime this program can actually only find pages which don't have
+Currently this program actually only lists pages which don't have
 an interwiki link to the English Wikipedia. This is obviously not useful on
 the English Wikipedia and is conceptually problematic on other Wikipedias,
 too. This is being fixed, but it is not simple to do it Right.
 
+Goal: 0.4 Reut
+
 =head2 Internationalization is far from perfect
 
 Date handling and strings localization is very primitive. There are plans
 to upgrade it to smarter modules such as Locale::Maketext.
 
+Goal: 0.6 Itay
+
 =head2 MediaWiki parsing is ad hoc
 
 This program only does very rudimentary and ad hoc MediaWiki syntax parsing.
 
+Goal: None at the moment, it works well enough.
+
 =head2 Templates must be removed manually
 
-Templates on pages which already have the needed are not removed
-automatically. This is a stub; you can help Wikipedia by writing these
-functions!
+Templates on pages which already have the needed link are not removed
+automatically.
 
-The actual reason for this is that the author doesn't want to write a bot
-that touches the live online Wikipedia until he is very sure that the rest
-of the script is very stable. Besides, manual work tends to make articles
-Wikipedia articles better! Quality is more important than quantity and speed.
+Goal: v0.2 Noa
 
 =head2 Cooling date
 
 The implementation of the cooling date is very rudimentary.
 
-=head2 No separation of searching and formatting
+Goal version: v0.4 Reut
 
-There are two main function here: C<find_iwless()> and
-C<create_no_iw_pages()>. They are doing separate things and should run
-from different programs.
+=head2 Major refactoring is needed
 
+=over
+
+=item * The main code is on the brink of passing the threshold for complexity that
+P::C accepts.
+
+=item * There is no separation of searching and formatting. There are two main
+function here: C<find_iwless()> and C<create_no_iw_pages()>. They are doing
+separate things and should run from different programs.
+
+=item * Statistics and multi links are just slapped to the log.
+
+=item * At least some of the code can be rewritten as classes that inherit
+from L<Parse::MediaWikiDump>.
+
+=back
+
+Goal: v0.8 Moshe
+
+=head2 There's no test suite
+
+That can be done after proper modularization. Also, a local test MediaWiki
+server would be needed.
+
+Goal: v1.0 Drora
+
 =head1 HISTORY
 
 =over
@@ -1441,7 +1466,8 @@
 categories sorting. Memory usage optimization - accumulating information in
 files. More generic, but far-from-perfect handling of links to languages
 other than English. Translitetaion with Lingua::Translit. Logging with
-Log::Log4perl.
+Log::Log4perl. Brutal Perl::Critic 1.90. Started using Readonly. Not finished:
+complete statistics, removal of templates from pages which already have links.
 
 =item * B<0.1 - First and unnamed Amir E. Aharoni's version>: Types
 introduced. Conceptual l10n, but only tested on he.wiki. Still en links


This was sent by the SourceForge.net collaborative development platform, the world's largest Open Source development site.