[Top][All Lists]
[Date Prev][Date Next][Thread Prev][Thread Next][Date Index][Thread Index]
[Gnu-arch-users] re: doc formats
From: |
Thomas Lord |
Subject: |
[Gnu-arch-users] re: doc formats |
Date: |
Fri, 20 Jan 2006 08:48:49 -0800 |
Another good rule-of-thumb test for evaluating wiki syntax
designs: how hard is it to self-document?
Every wiki syntax processor in the world winds up with
documentation in the form of a table:
Type This: Get This
*foo* *foo*
etc.
How good does the table look in source form? Are there
cases in which the entry in either column has to be "faked"?
This rule-of-thumb test gets at how clean the quoting rules
are in the syntax and how well the syntax handles "composibility"
(the idea that you can move subtrees around between contexts
fairly liberally).
Be very skeptical of any system that can't handle this case
without embedding raw HTML.
-t