Hi, This is my (uncensored :-) feedback following the SDK build.
1) Doc inconsistency: There are 3 differents docs explaining how to build the SDK: - WIKI: https://cwiki.apache.org/confluence/display/FLEX/1.2+Setting+up+Manually - WEB: http://flex.apache.org/dev-sourcecode.html - README file in sdk root. Which contain the potentially inconsistent information: a) README says JAVA 1.6 minimum is required , whereas WIKI only states "download java". I was using JDK 1.5 and got into an issue when building the "modules" (target 1.6 not valid). => I think the wiki shoul also mention 1.6 minimum requirement b) git commands to retrieve the repos: - README says git clone https://git-wip-us.apache.org/repos/asf/flex-sdk.git sdk - WEB says same as README - WIKI says git clone [https://git-wip-us.apache.org/repos/asf/flex-sdk.git] flex-sdk Note: actually, maybe 3 sources of information on how to build the SDK are just too much. Maybe only the WIKI should be kept, and the README just provide a link to the wiki. That would make maintenance easier. 2) When launching the build for the first time, it fails because the "modules" (FlexTasks, mxmlc, etc..) are not built yet. => either mention in the doc that modules needs to be built before hand => or better, add a dependency in the main build so that it's done automatically , if not present. 3) missing values: TLF_HOME is missing from env-template.properties 4) build.properties not up to date => fixed 5) .actionScriptProperties and .flexLibProperties are missing from .gitignore => controversial. 6) Fred told me I should set " core.autocrlf" to "input" to avoid issues when committing from Windows. => I think this should be set per-repository in the .gitattributes of flex-sdk and flex-tlf, so that everyone has the same settings, and we don't have to bother about that anymore. 7) Fred says I need to run "ant other.locales" to avoid trouble in French env. This is not mentioned anywhere in the doc. => Add to the WIKI. Regards, Maurice -----Message d'origine----- De : Alex Harui [mailto:aha...@adobe.com] Envoyé : jeudi 26 septembre 2013 18:32 À : dev@flex.apache.org Objet : Re: Building the SDK from git On 9/26/13 9:12 AM, "Maurice Amsellem" <maurice.amsel...@systar.com> wrote: >BUILD SUCCESSFUL! > >YEEHAA! > >Do you me to recap the few issues I have faced as a "newbie"? Sure. I think you'll be getting write access soon, so then you'll be able to update the README yourself. -Alex
