[Date Prev][Date Next][Thread Prev][Thread Next][Date Index][Thread Index]

[tdf-moderators] Drafts of new listtexts


Hello,

some of you know that we use mlmmj as a mailing list software. Their author, Ben Schmit, has drafted new list texts and there's a chance to review them. If you have any feedback, either send it to the mlmmj mailing list directly (subscribe beforehand), or send them to me.

I guess we all could benefit from improvements, that's why I am sharing.

Thanks,
Florian

-------- Original Message --------
Subject: [mlmmj] Drafts of new listtexts
Date: Mon, 21 Feb 2011 23:14:06 +1100
From: Ben Schmidt <mail_ben_schmidt@yahoo.com.au>
To: mlmmj <mlmmj@mlmmj.org>

OK! I finally did it! I've drafted new English listtexts!

I've used the features of conditionals and wrapping to cut down
duplication and allow more specifics to be included. I've tried to
strike a good balance between reducing duplication and having simple
conditionals, as these two goals conflict. I've also included text for a
feature or two that are due to be implemented soon. Some, though perhaps
not all, of these features will be in 1.2.18, but in order not to
require too many localisation efforts too soon, I am drafting all the
text now.

The thing most worthy of note is that I have changed some terminology:
Moderation of subscriptions is now known as gatekeeping, and the people
who perform it as gatekeepers--their job is either to permit or obstruct
a person's entry to the list. I also now refer to a moderator's job as
either releasing or rejecting a held post.

My work can be viewed here:
http://mlmmj.org/hg/listtexts/file/master/en

I'm interested in comments from developers, sysadmins, translators and
users. Do these texts adequately reflect the features of Mlmmj? Are the
features they describe or imply sensible? Do they read well? Are they
easy enough to translate? Are they easy enough to customise and
maintain?

Some more minor comments:

- I intend to move the first paragraph of each listtext (which is the
same) into a separate 'include file' shortly.

- I have drafted a few other minor changes of keywords and so on. This
is not final yet, and won't affect localisation.

- I've also changed the listtext naming scheme to be more consistent and
flexible. I will document this more fully later, but in brief,
listtexts are now named with a scheme of purpose-action-reason-type;
parts may be dropped off the end and instead the listtext may deal
with the multiple possibilities for that part using conditionals.

- Everything here will be implemented in a backward-compatible way, so
old listtexts will continue to work (though not with the new
features). However, I'm shamelessly paving the way for some
incompatibilities which will come in a version 1.3.0 before too long
(though probably with an upgrade script), and 2.0.0 further down the
track.

Ben.

--
Florian Effenberger <floeff@documentfoundation.org>
Steering Committee and Founding Member of The Document Foundation
Tel: +49 8341 99660880 | Mobile: +49 151 14424108
Skype: floeff | Twitter/Identi.ca: @floeff

--
E-mail to moderators+help@documentfoundation.org for instructions on how to unsubscribe
List archives are available at http://listarchives.documentfoundation.org/www/moderators/
All messages you send to this list will be publicly archived and cannot be deleted

Privacy Policy | Impressum (Legal Info) | Copyright information: Unless otherwise specified, all text and images on this website are licensed under the Creative Commons Attribution-Share Alike 3.0 License. This does not include the source code of LibreOffice, which is licensed under the GNU Lesser General Public License (LGPLv3). "LibreOffice" and "The Document Foundation" are registered trademarks of their corresponding registered owners or are in actual use as trademarks in one or more countries. Their respective logos and icons are also subject to international copyright laws. Use thereof is explained in our trademark policy.