Mailing-List: contact flex-dev-help@incubator.apache.org; run by ezmlm
Precedence: bulk
Reply-To: flex-dev@incubator.apache.org
Received-SPF: pass (nike.apache.org: domain of masuland@gmail.com designates
 74.125.82.43 as permitted sender)
From: Sebastian Mohr <masuland@gmail.com>
Mime-Version: 1.0 (Apple Message framework v1084)
Content-Type: multipart/alternative; boundary=Apple-Mail-4-774610309
Subject: Proposal: Code Example / Application Development Procedure (was: Re:
 Non-core code,
 contrib and samples (was: Goal for Flex: Strengthening large-scale Flex
 applications...))
Date: Thu, 19 Jan 2012 12:56:01 +0100
In-Reply-To: 
 <CAF2yXuoWFhWenBvzdVL6+4CVXCJFF1QxJg6mEgLE3a+Qirt1VA@mail.gmail.com>
To: flex-dev@incubator.apache.org
References: 
 <CAEdpnA37qM_kJMs3=fGQcQ6+J0XBMKv=h9r+5=AqZbSUBvUsPA@mail.gmail.com>
 <CB38F81E.3A10F%aharui@adobe.com>
 <CAF2yXuoWFhWenBvzdVL6+4CVXCJFF1QxJg6mEgLE3a+Qirt1VA@mail.gmail.com>
Message-Id: <6B0DD3B4-E307-46C1-8498-8EF2DA251965@gmail.com>

--Apple-Mail-4-774610309
Content-Transfer-Encoding: quoted-printable
Content-Type: text/plain;
	charset=us-ascii

Due to our last discussion about code examples, I would like=20
to discuss the procedure we should follow when writing these=20
code examples.=20

I also would like to point out that there is a difference between=20
writing Component Code Examples which should illustrate the=20
functionality of a component (Spark-DropDownList or MX-
ColorPicker), and, Application Code Examples which should=20
illustrate how to build (large-scale) Flex applications.

I am personally more interested on writing Application Code Examples
with or without the use of Microarchitectures, because I think the =
community=20
and Adobe already created lots of Component Code Examples:

Flex 3, http://livedocs.adobe.com/flex/3/html/index.html
Flex 4.6, http://help.adobe.com/en_US/flex/using/index.html

...

Proposal: Code Example / Application Development Procedure

This is the proposal for writing (large-scale) Application Code =
Examples:

'Before working on your Application Code make sure you have specified =
the requirements of the application in a Specification Document, and, =
you have defined an Application Coding Standard. An "Application Coding =
Standard" consists of a set of Nanoarchitectures / Architectural =
Patterns which describe the structure of your application, and, some =
coding guidelines collected in a Coding Conventions document.'

For more information please check out the diagram on this site:

http://code.google.com/p/masuland/wiki/ApplicationDevelopmentProcedure

I would be happy to find some kind of consensus on this topic here in =
Apache Flex.


-- Sebastian


On Jan 16, 2012, at 8:37 AM, Peter Elst wrote:

>> And thus, we should probably not use application frameworks in our =
examples
>> on the project website.  The application framework vendors should =
have
>> their
>> own examples on their website.
>=20
>=20
> Maybe we could have a wiki with references to those application =
framework
> vendor examples, and other Apache Flex specific articles, tutorials, =
sample
> code.
>=20
> I'd be happy to work on that if it there is no objection to that =
getting
> set up.
>=20
> - Peter


--Apple-Mail-4-774610309--