RE: [flexcoders] Request to Adobe re: Documentation format

Thu, 23 Mar 2006 13:23:37 -0800

I can assure you we read this and other forums. Hey, where do you think my best code samples come from? ;)
 
As for changing the numbering format of the docs, I've forwarded Cortlandt's request on to one of the editors, but changes like that would have to be approved at a much higher level in order to make their way into the template. Let's just say it's not going to happen for Beta 3. :) 
 
Matthew Horn
Flex docs

From: [email protected] [mailto:[EMAIL PROTECTED] On Behalf Of dos dedos
Sent: Wednesday, March 22, 2006 4:24 PM
To: [email protected]
Subject: Re: [flexcoders] Request to Adobe re: Documentation format

Thank you very much for the links. Big help!

I'm sure Adobe documentation team will find your ideas re document structure pretty useful.

Just one note on a much higher level :) ...

I view programming languages are basically formal logic systems having non-universal axioms (i.e. "non-logical" in the formal sense) and rules of inference, so it follows that:

1. Some perfectly well formed statements in any given language would be impossible to prove as perfectly executable (i.e. with no error) based on the axioms of the language, and this holds true no matter how many axioms we add to the system.

2. Any given programming language could only be proven to be consistent by other languages. This makes the consistency proof conditional on the consistency of the second language, which in turn could only be validated by a third, and so on. No consistency proof for any formal logic system could be final.

That's why I stopped worrying a! nd learned to love the inconsistency.

:)


Cortlandt Winters <[EMAIL PROTECTED]> wrote:
Hi Dos Dedos,

They are here

http://labs.macromedia.com/wiki/index.php/Flex:Release_Notes#Beta_2_documentation

If any adobe docs folk do read this to look for requests, it would be nice in the future for alpha docs to be chaptered and indexed with page numbers offset by chapter rather than by total (like they do with tax and legal docs). The reason that would be nice is that you could print out a pdf and then when a new version of a chapter pops up, you can just reprint out that one chapter. If the page numbers are reletive to the chapters we can have printouts that change as the alpha docs do without getting page numbers out of synch.

I still like to print out docs, mainly when learning something new, so that I can write in the margins, highlight points, and review it later.

I love that the level of technical scope in the Flex2 docs is generally a level higher than flash docs in the past. These seem written more for programmers than for the casual coder as has been in the past. I like the little notes as to why a certain language design choice was decided upon amongst options. It inspires more confidence into the thinking behind the choices.

-Cort

On 3/22/06, dos dedos <[EMAIL PROTECTED]> wrote:

I'm glad the new Beta 2 IDE includes links to documentation ...

I was wondering if we can have it in Adobe Acrobat f! ormat so we can print it and read it offline?




Yahoo! Mail
Use Photomail to share photos without annoying attachments.


--
Flexcoders Mailing List
FAQ: http://groups.yahoo.com/group/flexcoders/files/flexcodersFAQ.txt
Search Archives: http://www.mail-archive.com/flexcoders%40yahoogroups.com


YAHOO! GROUPS LINKS




Blab-away for as little as 1ยข/min. Make PC-to-Phone Calls using Yahoo! Messenger with Voice.


--
Flexcoders Mailing List
FAQ: http://groups.yahoo.com/group/flexcoders/files/flexcodersFAQ.txt
Search Archives: http://www.mail-archive.com/flexcoders%40yahoogroups.com


YAHOO! GROUPS LINKS



Reply via email to