Masterview devel - Sep 2006 - [Masterview-commits] [246] trunk/masterview/doc/developer.html: Snapshot incomplete work in progress documenting directive implementatino framework.

Documentation looks good!

In regards to your question about developer.html

"As noted in the overview, most directive processing is associated
with the <code>:stag</code> event, when the directive can manipulate
the attributes of the element, or with the <code>:content</code> or
<code>:element</code> events when performing transformations on the
element output.
+Processing done on the <code>:etag</code> event is typically
associated with conditional directives that control the presence or
absence of the element in the output document.
+<i>[### is that right??? ###]</i>
+</p>


Yes, the majority of directives implemented to date predominately use
element to replace. stag is used for attribute manipulation, content
when only the content needs to change, and stag + etag when completing
a block that wraps the element.

Great job in expressing all this in words!

Jeff

>> stag is used for attribute manipulation, content when only the content 
>> needs to change, and stag + etag when completing a block that wraps the
element.

Got it, rewrote that paragraph a bit to better express when/why etag is
used.

The doc still needs work describing what goes on during the actual rendering
processing (what form things get accumulated, the relation between the
directive rendering accumulator and when things get rolled into overall
element rendering and into the final output) and better discussion of the
render services that a handler would use.

But it''s coming along; be good to get some additional feedback after
this
settles out a bit more from any of our users who''ve written directives.

~ Deb