[Twisted-Python] lore
glyph at divmod.com
glyph at divmod.com
Wed May 17 11:01:55 MDT 2006
On Wed, 17 May 2006 12:48:33 -0400, James Y Knight <foom at fuhm.net> wrote:
>On May 17, 2006, at 11:57 AM, Manlio Perillo wrote:
>>I've noted that web2 uses reStructuredText.
>I did that because I hate lore, but everyone else seems to dislike that I
>did so, and plans to convert those docs back to lore format. I'd rather
>that ReST became the recommended doc format, instead of converting those
>back to lore, but have no free time to try to push that viewpoint.
FWIW, I really wouldn't be opposed to ReST as a _format_, as long as it fit into the rest of the toolchain. If anyone else shares james' dislike of extremely limited HTML as an input format and user interface[1] to the documentation system, writing an input plugin for lore to recognize it would be a good first step.
[1]: I can see why you might. While I personally don't mind typing angle brackets (it's a soothing distraction from all that thinking), Lore's input format was in part a bet that Mozilla Composer would be reasonable and ubiquitous for end-users in a year or two... three years ago. Remember Mozilla? Hee.
More information about the Twisted-Python
mailing list