[darcs-users] Gitit on test.darcs.net: document which markup syntax on the "edit" page

[Max Battcher]

On 5/12/2009 22:15, Gwern Branwen wrote:
> On Tue, May 12, 2009 at 9:45 PM, Mark Stosberg<mark at summersault.com>  wrote:
>>>> http://test.darcs.net/_login
>>>>
>>> John says he's done something in HEAD for this:
>> Great! Thanks. Here's another specific feedback point.
>>
>> On the edit screen, it should explain *which* wiki syntax is in use, and
>> provide some immediate examples and a link to further documentation
>> about the formatting.
>>
>> Here's an example wiki page that does this decently well. (It will ask
>> you sign in first, which merely involves typing in any username that you
>> make up).
>>
>> http://www.cgi-app.org/index.cgi?action=edit&page_name=Plugins
> ...
>>     Mark
>
> I dunno, that's some pretty darn intrusive informing it does there.
> Seems like way overkill. I'm for user-friendliness, but that seems to
> go past the line of helping to getting in one's way.

Agreed. For reST, I would probably just link to rst2a.com and the cheat 
sheet from docutils:

http://docutils.sourceforge.net/docs/user/rst/cheatsheet.txt

--
--Max Battcher--
http://worldmaker.net