Forthcoming.

Pane Terminology

We should replace the phrase "put div" with the phrase "side pane". This is more meaningful to web presentation developers. Along with this change, we should introduce the phrase "menu target pane", or just "target pane", to indicate the pane that gets new content when presentation readers navigate through a presentation. When describing this phrase in the presentation developer documentation, be sure to stress that its meaning is relative to the menu. Different menus in the menu cascade have different target panes. The documentation should indicate what side panes are for: content that stays in place for all menu items in a menu. The kind of content in a side pane is often a diagram or code file that requires several target panes to describe fully.

Client Terminolgy

We need clearer terminology for LS_Repository clients. There are three types depending on the use of the fetched element (a HTMLElement instance):

• Target pane clients — the fetched element is used as a target pane.
• Side pane clients — the fetched element is used as a side pane.
• Insert clients — the fetched element is used as an insert into either a target pane or a side pane.

Callback Terminology

There are two kinds of callbacks: installation callbacks and pane callbacks (or processing search callbacks).

• Installation callbacks are used for installing all fetched elements. The callback styles the element and places it wherever it is needed.
• For an elements fetched as an insert there is no need for further processing. However, an element fetched as a pane needs to be searched for additional required processing. The required processing depends on whether the pane is a navigation target pane or a side pane.
• Navigation target pane elements need to be searched for menus, progressions, side panes, and inserts.
• Side pane elements only need to be searched for inserts. This is not currently implemented, but it will be implemented in the near future.

Pane callbacks (currently called load callbacks) are currently invoked for all target pane elements, even if the loaded element is an error element. This will be fixed in the near future to bypass search callbacks for error elements. An error element should not contain any layout panes, menus, progressions, or inserts.