atom feed128 messages in org.apache.incubator.flex-devRe: Project Goshawk [was Time for an ...
FromSent OnAttachments
46 earlier messages
Martin HeideggerFeb 16, 2012 4:55 am 
Martin HeideggerFeb 16, 2012 4:57 am 
Roland ZwagaFeb 16, 2012 5:00 am 
Martin HeideggerFeb 16, 2012 5:07 am 
Carol FramptonFeb 16, 2012 5:34 am 
Rui SilvaFeb 16, 2012 6:40 am 
David Francis BuhlerFeb 16, 2012 7:07 am 
David ArnoFeb 16, 2012 8:10 am 
Omar GonzalezFeb 16, 2012 8:47 am 
Martin HeideggerFeb 16, 2012 8:51 am 
Jeffry HouserFeb 16, 2012 8:52 am 
David ArnoFeb 16, 2012 9:07 am 
Gordon SmithFeb 16, 2012 10:00 am 
David ArnoFeb 16, 2012 10:01 am 
Scott DelamaterFeb 16, 2012 10:22 am 
Jeffry HouserFeb 16, 2012 10:38 am 
Bertrand DelacretazFeb 16, 2012 10:52 am 
Dave FisherFeb 16, 2012 11:09 am 
Roland ZwagaFeb 16, 2012 11:48 am 
Martin HeideggerFeb 16, 2012 11:51 am 
David ArnoFeb 16, 2012 12:04 pm 
OmFeb 16, 2012 12:10 pm 
Roland ZwagaFeb 16, 2012 12:23 pm 
Roland ZwagaFeb 16, 2012 1:03 pm 
Maciek SakrejdaFeb 16, 2012 1:24 pm 
Michael A. LabriolaFeb 16, 2012 7:33 pm 
andrei apostolacheFeb 17, 2012 1:23 am 
Roland ZwagaFeb 17, 2012 1:25 am 
Roland ZwagaFeb 17, 2012 1:29 am 
Roland ZwagaFeb 17, 2012 1:41 am 
Left RightFeb 18, 2012 11:48 am 
Ariel JakobovitsFeb 19, 2012 12:11 am 
Roland ZwagaFeb 19, 2012 1:57 am 
almansour belleh blancoFeb 19, 2012 2:22 am 
Roland ZwagaFeb 19, 2012 2:47 am 
Martin HeideggerFeb 19, 2012 3:06 am 
Left RightFeb 19, 2012 4:03 am 
Left RightFeb 19, 2012 4:34 am 
Martin HeideggerFeb 19, 2012 4:59 am 
Ariel JakobovitsFeb 19, 2012 8:51 am 
Michael A. LabriolaFeb 19, 2012 9:17 am 
Omar GonzalezFeb 19, 2012 9:23 am 
Michael A. LabriolaFeb 19, 2012 9:35 am 
Alex HaruiFeb 19, 2012 11:27 am 
Michael A. LabriolaFeb 19, 2012 11:43 am 
Alex HaruiFeb 19, 2012 11:49 am 
Left RightFeb 19, 2012 12:50 pm 
David ArnoFeb 19, 2012 1:46 pm 
David ArnoFeb 19, 2012 1:57 pm 
Michael A. LabriolaFeb 19, 2012 2:04 pm 
32 later messages
Subject:Re: Project Goshawk [was Time for an Apache Flex compiler.]
From:Maciek Sakrejda (m.sa@gmail.com)
Date:Feb 16, 2012 1:24:19 pm
List:org.apache.incubator.flex-dev

Very nice. Have you considered RST [1] (or another markup language) for the design document formatting? It's readable as plain text, github displays some of these natively (I think at least RST and Markdown), and RST can be "compiled" to PDF or HTML (e.g., Python uses it for their documentation and generates output with Sphinx [2]). Also, being plain text, it's fairly easy to merge proposed changes to sections of your design document.

The main downsides are that formatting is limited (probably not an issue--an asset, in fact--in something like a design document) and that tables can be a royal pain (it's WYSIWYG, so you frequently need to massage the table structure if you change data).

[1]: http://docutils.sourceforge.net/docs/user/rst/quickref.html [2]: http://sphinx.pocoo.org/rest.html