On Tue, March 6, 2007 2:34 pm, Denis Perelyubskiy wrote:
> Finally, on the subject of converting the comments - it is entirely a
> manual process, that can not be automated. Comments need to be
> integrated into the   body of the main tip (maybe the tip needs to be
> adjusted, reworded, etc). We should just push out the existing pages,
> and then set to work on reworking the tips by hand. Eventually we'll
> be done.

I agree mostly.  The process of moving the tips from vim.org to the wiki
host can be automated.  Ideally, I also think that it would be a good
idea to refactor some comments into the body of some tips, but I
certainly don't think that it's necessary for every tip.

For example, I wrote tip number 1280 which, in hindsight, is pretty
lame.  My tip has one comment from someone who agrees that my tip is
lame :)  Also, I imagine that about 5 people a year read this tip, and
those people probably were looking for something else anyways.

In that situation, do we *really* need to merge the comment with the
tip?  No one uses the tip, and the comment's pretty pointless.  Why
don't we just ignore it?

On the other hand, there are some tips that are used hundreds of times a
week.  These tips will probably be refactored and updated very quickly
due to the sheer number of eyeballs reading it.

So I guess what I'm saying is, what's wrong with waiting for "the
community" to refactor these tips using guidelines from the wikibook
admins?

Thanks!

Tom Purl


Reply via email to