View Source

.sidePanel {clear: right; float: right}
li ul {margin-top: 0px;}

Logistics

Date: Thursday and Friday, Sept. 8 & 9, 2011
Time: 9:30am EDT - 4:30pm EDT each day
Coordination: the #fluid-work IRC Channel

Where to work

New documentation should be created in the documentation space: Infusion Documentation

If you're not sure where to put something, ask in the channel or make your best guess. We'll be cleaning things up after the sprint, so don't fret about it.

When you create or update a page, please add a link to it to this page (if there is none).

Topics and Suggested Authors

Must-Haves (API changes)

Review "Onion Rings" tutorials (Antranig)
- Tutorial - Getting started with Infusion

Update FSS docs based on recent changes
- Intro
- Cheat sheet
- Demos
- See Changes in Infusion 1.4#Fluid Skinning System for list of changes

Update UIO dependency docs to mention new fss-text-uio.css file

Double-check the new UI Options API docs (Cindy)
- - check for missing/wrong things (e.g. list of options or configurable subcomponents is correct?)
  - fill in/correct text descriptions of things
  - double-check examples, add any missing examples
  - etc.
- Full Page UI Options
- Full Page UI Options (with Preview)
- User Interface Options API
- UI Options API - base component
- Sliding Panel
- Render IFrame
- Template Loader
- Text Controls
- Layout Controls
- Links Controls
- Cookie Settings Store (Justin?)

Create new UI Options Tutorials
- how to set up full page Tutorial - Full Page UI Options
- how to set up full with preview Tutorial - Full Page UI Options (with Preview)
- how to set up fat panel Tutorial - Fat Panel UI Options

Review the new UI Options Tutorials (Mike)

Update the Table of Contents API to reflect any changes (Anastasia)
- Table of Contents API and subcomponents

Updated UI Enhancer docs
- updated UI Enhancer API docs
- new UI Enhancer tutorial Tutorial - Page Enhancer

Review new UI Enhancer docs (Michelle?)
- UI Enhancer API docs
- Tutorial - Page Enhancer
  - check for missing/wrong things (e.g. list of options or configurable subcomponents is correct?)
  - fill in actual text descriptions of things
  - add missing examples, etc.

Review and update existing IoC docs (Yura)
- These docs have become out-of-date with recent changes to the framework

How to create something with IoC (Yura)
- simple program as basis for a tutorial
- James/Caroline's data visualization app?
- Update How to Use Infusion IoC to more current recommendations

Framework Debugging Guide (Antranig and Yura)
- How to turn on logging
- How to read the logging output
- Firebug tips?
- Where in a typical demands-resolution call stack to look for things, and what to look for
- Maybe include a "trouble-shooting" section: symptoms of typical problems and what the likely causes are

Pseudoarguments (Colin?)
- how to use them
- how to define them using the "argumentMap" option

Finish the Component Grades documentation (Justin)

Update Renderer Component Tree Expanders docs
- repetition and condition expander

Update the docs on Renderer Decorators (Michelle?)
- including new functions:
  - fluid.renderer.getDecoratorComponents (most useful)
  - fluid.renderer.clearDecorators
  - fluid.renderer.visitDecorators

changes to produceTree configuration (Cindy)
- see http://issues.fluidproject.org/browse/FLUID-4190
- initRendererComponent Options
- Renderer Components
  Note from cindy: FLUID-4190 added 3 events on the rendererComponent to provide more flexible control on renderer tree. According to the location of these 3 events, the doc change goes into Renderer Components rather than initRendererComponent Options.

new renderOnInit flag (Anastasia?)
- see http://issues.fluidproject.org/browse/FLUID-4259
- initRendererComponent Options

Update Inline Edit API docs to reflect changes
- Rich Text Inline Edit API
- See Changes in Infusion 1.4#Inline Edit for summary

Update Pager API docs to reflect changes
- Pager API
- See Changes in Infusion 1.4#Pager for summary

Update Uploader API docs to reflect changes (Colin/Mike?)
- See Changes in Infusion 1.4#Uploader for summary

extensions to model accessors (fluid.get) (Yura)
- accepts JSON as EL path now
- see http://issues.fluidproject.org/browse/FLUID-4039

General design/usability review of new docs space: Infusion Documentation (James)
- see Infusion documentation redesign (April 2011) for design "inspiration" (new docs space is intented to be a step on a migration toward the new design)
  - look and feel?
  - layout?
  - navigation?
  - language?

Code review of Instructional Demos (Justin)
- UI Options - Default (all listed)

Design review of Instructional Demos (James)
- UI Options - Default (all listed)
  - see Infusion documentation redesign (April 2011) ("Demos: Component") for design "inspiration"

Would Really Be Great

General Guide To Working With IoC-Enabled Infusion Components (Anastasia?)
- what it means when a component has subcomponents
- the difference between configuring using options and configuring using demands blocks
- understanding specificity of demands blocks, and how to figure out how specific to make yours
- understanding why you may have to replicate the contents of an existing demands blocks in your demands blocks
- etc.

Finish "Onion Rings" tutorials (Anastasia?)
- Tutorial - Getting started with Infusion

UI Options 1.4 Upgrade tutorial (Mike?)

Docs on component tree expanders (Colin?)
- e.g. deferredCall, deferredInvokeCall, deferredFetcher and noexpand

UI Options "instructional demos" (Anastasia)
- in progress

Tech review of FSS Instructional Demos on the wiki (Heidi?)
- are these the recommended ways of using the FSS?

Finish the Subcomponent Declaration documentation (Anastasia?)

Explain "instantiators" (Yura?)

Explain the new nomerge and noexpand merge policies
- Options Merging for Infusion Components

A page on fluid.fetchResources (Cindy?)
- including the use of "fetchClass" to enable "Proleptic Joinsets"

Event Priorities (Mike?)
- specify "priority: <val>" as an option
- acceptable vals are "first", "last" or integers; higher numbers go first, lower numbers go last; negatives allowed;
- default is "undefined" if not specified; typeFounts automatically first
- how sorted for undefined? last, except for "last"

Improve Renderer Component Tree Expanders docs to include the HTML that goes with the code (Anastasia?)

Simple Renderer tutorials, such as (Anastasia?)
- how to render radio buttons
- how to render checkboxes
- how to render drop-downs
- how to render repeated things using the "repeat" expander
- how to bind things to a data model
- how to render tables
  - see a conversation in #fluid-work explaining how to render tables with the Renderer: http://wiki.fluidproject.org/display/fluid/fluid-work+IRC+Logs-2010-06-16
- Instructional demos have been started, at Renderer Instructional Demos
  - code at https://github.com/acheetham/Infusion-Instructional-Demos

If We Have Time

Component priorities (Cindy?)

Demands blocks: when to use nickname, when to use fully qualified (Michelle/Colin/Yura?)

Finish Progressive Enhancement docs (Cindy?)

Finish Model Transformation docs (Justin?)

fluid.progressiveCheckerForComponent (Colin?)

Document new framework functions (everyone!)
- NOTE: We have a template for function API pages - if you're going to work on them, ask how to use it
- fluid.tryCatch
- fluid.log (new parameters)
- fluid.hasGrade
- fluid.typeTag
- fluid.typeFount
  - also a gradeName of the same name?
  - currently used by the progressive checkers.
  - requires an option named "targetTypeName"
  - returns a type tag with that name
  - note: creation priority defaults to "first" (but can be overriden)
  - general purpose of a typeFount might be to define something that might guide the instantiation of other component (e.g. the progressive checkers)
  - see http://issues.fluidproject.org/browse/FLUID-4191
- fluid.deferredCall
- fluid.deferredInvokeCall
- fluid.expander.deferredCall
- fluid.expander.noexpand
- fluid.expandOptions
- fluid.fetchContextReference
- fluid.invoke
- fluid.makeFreeInvoker
- fluid.makeInvoker
- fluid.noexpand
- fluid.parseContextReference
- fluid.renderContextReference
- fluid.resolveEnvironment
- fluid.singleThreadLocal
- fluid.staticEnvironment.environmentClass
- fluid.threadLocal
- fluid.freeInstantiator
- fluid.explode
- fluid.explodeSelectionToInputs
- fluid.extractTemplate
- fluid.resolveMessageSource
- fluid.ariaLabeller
- ... and many more!

Tutorial: Creating an FSS Theme (Anastasia)

Tutorials for renderer component tree expanders (Yura?)
- e.g. fluid.renderer.repeat, fluid.renderer.condition, etc.

Finish the 'reordered with JSON-based callback' tutorial (Harris?)
- see a thread on the Infusion-users mailing list explaining how to use the Reorderer with a JSON-based callback: http://fluidproject.org/pipermail/infusion-users/2010-July/000204.html

Aria labeller (Heidi?)