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

John Beckett johnb.beckett at gmail.com
Tue Jul 24 23:13:42 UTC 2007


hermitte at free.fr wrote:
> There are times where the talk page is more
> suited than any other media.

Yes I agree. The question concerns how often the talk page is more suited
than just adjusting the comments, in the case of most old tips.

I looked through 'candidates for deletion' recently and saw that ipkiss has
put a couple of tips in there. On at least one tip that I noticed, he had
put a rationale at the top of Comments. I think that's an excellent
strategy. It's easier for the person recommending the page for deletion, and
it's easier for people to review.

Similarly, in tip 1 I have put a comment 'TODO: merge with tip 5' (and vice
versa in tip 5). Ipkiss has recently pointed out that I should have a
Duplicate template to handle that ... I'll probably do that within a week.
But just putting the comment where everyone can see it makes sense to me.

> When the comment expressed an opinion ... I'm not for
> deleting or systematically merging the comment. In such
> cases, moving the comment to the talk page could be the
> best choice -- IMHO.

My problem with that is the time and effort required for very marginal
benefit. As soon as you think, well perhaps I should keep that comment, you
find it very hard to justify deleting any other comment.

And what is the reward for the effort? You get a bunch of (usually) obsolete
material clogging the talk page. Remember that the original comments will be
preserved on vim.org, and we have a link to the original tip.

John



More information about the Vim-l mailing list