On 9/8/16, 8:31 AM, "Christofer Dutz" <christofer.d...@c-ware.de> wrote:
>I don't quite agree. > > >The problem with FlexJS is that you have to do things differently than >with Flex. For Flex the web is full of useful and less useful how-tos on >the topic, but for FlexJS there is next to nothing to be found. For sure, we want FlexJS framework component developers to do things differently: use beads, pay-as-you-go, platform-specific code, etc. The hope was that if you are a FlexJS application developer, there are fewer things you have to do differently than Flex. Maybe we need to roll out a new component set with better defaults. If, for example, there was a "mid-size" component set where its version of Container already bundled ContainerDataBinding, then the application developer wouldn't have to remember to add it as a bead. > > >It would be great to have some Documentation, walking an interested User >into the details and concepts of FlexJS. Without a "handbook" we have >some kick-ass software only kick-ass users will understand to use. I >doubt that targeting only the kick-ass users will bring us the >user-numbers we are looking for. It's not "features over all". The more >we do without documenting, the more documentation-debt we produce. We have this page already [1], but I just realized it needs updating: https://cwiki.apache.org/confluence/display/FLEX/Application+Structure. What are some of the details and concepts that should go in there or some other page on the wiki? Specifics would help. Just saying write more doc is too general. I've been under the hood too long to know what the big differences are to newcomers. > > >Perhaps we should start a wiki page, containing features we consider >important for a 1.0.0 and could add a dedicated docs-wish list. Jira sort >of doesn't cleanly support creating and prioritizing a big-picture. > I guess I don't care where we collect this information, but JIRA does seem to have a sub-tasks feature that would allow assignment of bits and pieces of the documentation to many different people. [1] https://cwiki.apache.org/confluence/display/FLEX/Application+Structure -Alex
