-----BEGIN PGP SIGNED MESSAGE-----
Hash: SHA1
On 6-Mar-07, at 3:34 PM, Denis Perelyubskiy wrote:
On Tue, 06 Mar 2007 11:31:53 -0700, "Steve Hall"
<[EMAIL PROTECTED]> said:
From: Hari Krishna Dara, Tue, March 06, 2007 11:33 am
and if we can enforce a fixed style on commenting such that the
comments don't look like a mess. I would imagine that one needs to
edit the tip to add their comment at the end, but it will be nice if
the comment itself happens as a discussion (which appears as a
discussion tab on the same page).
I agree, is there any way the porting process can push comments to
each tip's respective discussion tab?
why don't we discuss that here:
http://en.wikibooks.org/wiki/Talk:Learning_the_vi_editor/Vim/
TipsSandbox/Tip_1:_the_super_star
:-)
Seriously though, as I had mentioned on the discussion page, for me
as a
user of the tip, it is horribly counter-productive to go and read
twenty-five thousands comments on a page. I'd much rather just read a
"perfect" tip. This assumes, of course, that tip contributors care
about
me as a user. I hope they do :)
Wikipedia model seems to work great. One page. All the information.
Discussion on a separate page.
One change: if it matters, we could reserve a line (or two) for a list
of contributors. This information is available from the history
page for
those who care to look anyway, but maybe people care about their names
being mentioned.
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.
In any case, I think this will be an extremely useful resource
(especially if we could then put VIM's documentation on there, and
cross-link)
One of the first things I was thinking about mirrors the above comments.
http://en.wikibooks.org/wiki/Talk:Learning_the_vi_editor/Vim/
TipsSandbox/Tip_1:_the_super_star has a bunch of "thanks for the
great tip!" type comments with more useage info interspersed. I
think those 'great tip' comments go to a separate page, while the
'use # or % instead' kind of comments need to be edited into the
actual tip itself.
I don't think that can be automated though - so the question is
comments to a separate page and edited back in? or all on one page
and edited over to the secondary page...
Brian
-----BEGIN PGP SIGNATURE-----
Version: GnuPG v1.4.6 (Darwin)
Comment: Verify this email or encrypt your email for free - see gnupg.org
iD8DBQFF7dUhGnOmb9xIQHQRAlpVAJ45MZO4aj5DMVxdnN2Kvd85g6PoAwCff2AG
KdJM5sFvk/OcuLBVTVGeF6Q=
=MnvL
-----END PGP SIGNATURE-----
