Brendan Eich wrote:
> 
> Yeah.  Strong editors needed, the Wiki is just the front end, and maybe
> the patch-tool if Doctor isn't right.

I don't like WikiStyle links. They have several problems:

 a) They can unintentionally create links to non-existant resources.
    It's especially an issue with code documentation, 'coz we use
    the StudlyCaps naming convention throughout Mozilla.
 b) There is *no* inherent URI structure.
 c) Accessibility. And I don't just mean screen readers, but search
    engines as well.

If we want a structured text parser, reStructuredText[1] is one option.
IIRC, it doesn't accept HTML code as input, which may be a problem, but
it's become popular for Python docs, and it does have a sophisticated
set of constructs.

[1] http://docutils.sourceforge.net/

~fantasai
_______________________________________________
mozilla-documentation mailing list
[EMAIL PROTECTED]
http://mail.mozilla.org/listinfo/mozilla-documentation

Reply via email to