Task:  Wiki Format Sign-Off
Deadline:  Monday, May 21st (arbitrary, I know)

Overview
========

We've had some great, constructive discussions lately regarding how we
will be creating and editing tips in the future.  Before we can finally
decide how this is going to work, however, we need to decide upon a page
format for tips.

The most recently-updated wiki tip examples can be found at the
following URL:

* http://scratchpad.wikia.com/wiki/VimTest

The following tips should stand out:

* http://scratchpad.wikia.com/wiki/VimTip1
* http://scratchpad.wikia.com/wiki/VimTip1_v2

This first tip uses the Template:Tip template
(http://scratchpad.wikia.com/wiki/Template:Tip), and the second tip uses
the Template:Tip2 template
(http://scratchpad.wikia.com/wiki/Template:Tip2).

Requested Actions
=================

Please take a look at these tips, decide which one you prefer, and then
provide constructive criticism for that tip's format.  There's no such
thing as a dumb comment.

My Two Cents
============

I really like VimTip1_v2, which uses the Tip2 template.  Here's what I
like:

* No special formatting for commands or any other preformatted text.  I
  think that this is an essential requirement for the initial conversion
  effort.
* Easy to read
* Succinct

How do you want to handle comments?  Typically on a Mediawiki site, you
sign you comments like so:

    This is so cool! ~~~~
    ----

Which is then saved to the page like this:

    This is so cool! Tpurl 15:17, 15 May 2007 (UTC)
    
--------------------------------------------------------------------------------

It's a little ugly, but it's the norm in the wiki world.

What do you guys think?

Tom Purl


Reply via email to