[Vim-l] New guidelines (policies) for editing tips

Sebastian Menge s.menge at gmx.de
Tue Jul 31 13:52:24 UTC 2007


Am Sun, 22 Jul 2007 00:05:47 +1000 schrieb John Beckett:
> To prepare for this, I have been working on a set of guidelines for how
> to edit tips. I think this is important because we really need help, and
> I think we should try to make the best use of people's time if they
> start taking an interest.

I've tried to tidy up things a bit. We should get this in a shape we all 
can agree to, and write things down in a matter that newcomers can get 
involved quickly.

Here's what i've done: (mainly structure and layout )

0. Reworked the front page a bit.

1. Merged Project:Guidelines and Project:Policy to Project:Policy, since 
that is the common page for such things. Said something aabout different 
roles there: "Readers, Contributors, Editors". Is that ok?

2. Removed Tips_Ruleset completely, "golden rules" sounds nicer. This is 
the one that appears when submitting a new tip. perhaps this should be 
split in two pages sometime ...

3. Reworked the *_guidelines. Used ==In Short== and ==Examples and 
Explanations== everywhere, tried to give the things more structure, added 
some stuff

One thing to mention is that I removed the things on "delete tips for old 
versions of vim": There are a lot of ppl out there that have to use older 
versions of vim. Let's flag such tips (if they are valuable) with 
something like "obsolete since version xxx due to feature yyy". Spelling 
is a good example.

Please review everything thoroughly. Can you agree to everything, is it 
understandable and attractive for newcomers, are there things that are 
not clear?

Im convincend that these things are most important for the success of the 
wiki.

Sebastian.



More information about the Vim-l mailing list