--- lib/A3C.pod 2008/06/19 18:24:02 204 +++ lib/A3C.pod 2008/06/19 19:05:26 205 @@ -4,7 +4,13 @@ =head1 DESCRIPTION -This page describes general idea about A3C application and current status of implementation +This page describes general idea about A3C application and current status of implementation. + +Oppinions should be attributed to Dobrica Pavlinusic, and not other developers :-) +It's surposed to convey a story which is coherent enough for new developer +to join into project. Most of other documentation is more useful when +developing and looking into code usage (if it's not documented and tested, +it doesn't exist) but this part is delivered as pure POD for reading pleasure. =head1 LDAP @@ -74,12 +80,15 @@ have to take a look in C) implements pure DBI code (ported from php) to access data directly. Keep in mind that this data have to be cached for any resonable performance. On the other hand, data can be -structured usefully, for example trees are structured in useful way for JSON -direct JSON output. +structured usefully, for example trees are structured in useful way for +direct output to JSON. If tree has C key, it can be set to C so that we can mark errors in data using same CSS class in views. This might be useful convention. +I prefer to keep this file documented up to level that make it's usage from Jifty and +C makes sanse, but not more than that. + =head1 HTML We don't generate HTML using templates. In fact, all HTML is encoded in perl @@ -91,6 +100,22 @@ for us anyway) for easier maintenance, probably by same logic as view names to skip additional step of mapping when human are watching into code. +In long run, this should allow us to refactor templates at code level and +create different re-usable widgets which brings us to following topic... + +=head1 AJAX + +Jifty's way of AJAX are L. + +=head2 Strix navigation + +L + +For now, we have implementation of two-level select which is in sync with +instance clipboard (implemented by L and +L and L. This is +good candidate to refactor into reusable widget on it's own. + =head1 BUGS Many probably, documented in C which is also useful for quick overview