The process of developing this information, along with the related mind maps, have led to the development of a proposed architecture for the Infusion Documentation. The latest version of the proposal can be found at Documentation Architecture - Round 2.
|
This appears to be a slight subset of the audience for Component Demos. Audience for Component Demos also includes non technical users. (jh)
Advanced developer, new to InfusionName: Neal Neal finds the main Fluid Project site and clicks "Learn about Infusion." He starts with the demos, trying each one out and looking at the sample code. Impressed with the configurability of the components, he goes back to the "Learn..." page and follows links to information about the Framework itself. As he reads about the principles embodied in the Infusion code and the designs and practices used, he becomes more and more impressed. As he reads about the Renderer, he realizes something about its strengths that he didn't quite grasp just looking at the demos. Luckily, there is a link on the page to the demos, so he uses it to quickly go back and try the demos with the new insights in mind. He returns to the Framework documentation and reads about the IoC system. Recognizing the concepts from his work in Java with the Spring framework, he's surprised to see something like this available in a JavaScript framework. He reports back to his boss that Infusion is something that is definitely "worth using." Beginner developer, knows Infusion, specific goalName: Jamie Jamie has created an HTML template for what he wants his application's Uploader interface to look like. He turns to the Uploader API page and looks at the list of selectors described there. He understands what the selectors are for based on their name, but he's not sure how to apply them to his different markup (should a selector go on the <ul>? on the <div> around the <ul>?). Jamie follows a link on the API page to the Uploader Demos page. Here, he finds several different Uploader interfaces with different markup. By looking at where the selectors are on each of these examples, he comes to understand how to use them in his markup. Beginner developer, new to InfusionName: Mateo Mateo pokes around the Infusion site, looks at the demos, and thinks the Inline Edit is perfect for an image library application he's putting together. He follows a link on the Inline Edit demo page called "How to add the Inline Edit to your application." ... Advanced developer, new to InfusionName: Minerva (Minnie) Minnie finds the main Fluid Project site and clicks "Learn about Infusion." She reads the marketing-speak and is intrigued. She follows the "Demos" link and finds the Pager. After playing with the Pager demos and reading a bit about it on the demo page, she thinks it's worth looking closer. She uses the link on the demo page to get to the Download page and downloads the source distribution. Back on the demo page, she follows a link called "How to add the Pager to your application." ... Advanced developer, knows Infusion, advanced goalName: Valeriya Valeriya starts creating her Picture Gallery component by sketching out the basic creator function and defaults declaration, as she has observed in the Infusion source code. As she expands the code, she suspects that she'll want to encapsulate a particular piece of functionality as its own component, and have her Picture Gallery component use it. As she tries to implement this, she realizes that she doesn't quite understand how dependencies work, so she scans the main Infusion Documentation page. She sees words like "components" and "framework," but nothing that looks like it will help with dependencies. There is a link titled "How do I ... ?" Hoping that she might find something relevant, she follows the link. On the "How do I" page, she follows a link titled "How do I declare dependencies?" The resulting page has an explanation of the 'fluid.demands' function, some examples, and links to background and related information. She decides that she'd better read some of the background before continuing, so she starts with "About Infusion IoC." Experienced developer, new to Infusion, basic goalName: Takumi Takumi is an avid Drupal user and developer. He sees a demo of UIO and thinks it would be a great functionality to add to Drupal, so he decides to create a module for it. He finds the tutorial describing how to add the fat-panel UIO to a site and dives right in. The tutorial references various features of the Framework that Takumi needs to understand in order to build his module, so he starts reading. What does Takumi need to know about? (the following list has not yet been sorted into any order)
Experienced developer, new to Infusion, advanced goalName: Fadilah Fadilah has seen a demonstration of UIO and is sold on the idea of personalization. Her web application has various features that she's like users to be able to personalize, so she wants to create her own custom preferences editor. What does Fadilah need to know about? (the following list has not yet been sorted into any order)
Experienced developer, new to Infusion, accessibility goalName: Darren ... Web designer, new to Infusion, wants better CSSName: Mhari ... |