Relocate docs to their egg nest and prepare versions for release

svn path=/plone.app.kss/trunk/; revision=12283

README.txt

@@ -1,7 +1,67 @@
 plone.app.kss Package Readme
-=========================
+============================
+
+KSS (Kinetic Style Sheets) for Plone
 
 Overview
 --------
+This product gives generic KSS support for Plone. It depends on the product
+"kss.core".
+
+Installation
+------------
+
+Compatible with Zope 2.10, and Plone 3.0.
+
+Features implemented
+--------------------
+
+- Content tab replacer. This works with all the content (aka. "green") tabs
+  including the non-action tabs in the setup screens.
+
+  As we have no way to identify a macro for the content-region in the current
+  templating system of Plone, we render down the whole template. As a speedup,
+  we replace the main_template in the rendering context, this may or may not
+  have an effect depending on the template. If we cannot find a template at
+  all, we fall back to submit.
+
+  Missing/TODOS:
+
+     - The popups for leaving the edit region are not hooked in. (Needs
+       javascript which is avoided in the first round.)
+
+     - The loading of the kupu editor is done with a simple hack, it seems to
+       be no clean way in javascript to find when the iframe has been loaded,
+       some more complex hack is needed for this that works on all browsers
+       and is reliable in all the cases.
+
+- Portlet refresher
+
+  We currently refresh the "recent" portlet. The rendering of the portlet is
+  done by the general macro renderer, the portlet is then replaced in the 
+  client in its position.
+
+  There is one rule that is refreshing all the portlets, the only change
+  that needs to be done in the Plone templates is put a KssPortletRefresh
+  class to those portlet's outer <dl> tag that need to be refreshed.
+  Refreshing is done in every 30 seconds currently, this can be adjusted
+  from the template.
+
+- In-place calendar navigation: the two little arrows replace the calendar
+  portlet, without reloading the screen.
+
+  We put kss attributes on the calendar node for the year and month
+  to tell the server where to navigate. Actually, we could have done
+  that without modifying the template either, since the server could
+  have just received the original "href" of the little arrow and could
+  parse the year and month from that, but this is a cleaner solution.
+
+KSS extensions defined for general purpose use
+----------------------------------------------
+
+- A generic macro replacer server action
+
+- client action for submitting to an url
+
+- client action for submitting the current form
 
-KSS (Kinetic Style Sheets) for Plone

docs/HISTORY.txt

@@ -2,7 +2,14 @@ Changelog for plone.app.kss
 
     (name of developer listed in brackets)
 
-plone.app.kss - 0.1 Unreleased
+plone.app.kss - 1.2dev Unreleased
+
+    - ...
+
+plone.app.kss - 1.2-alpha2 Released 2007.02.10
+
+    - adjust for release
+	  [ree]
 
     - Initial package structure.
       [zopeskel]

plone/app/kss/version.txt

@@ -1 +1 @@
-1.2
+1.2dev unreleased

setup.py

@@ -1,7 +1,7 @@
 from setuptools import setup, find_packages
 import sys, os
 
-version = '0.1'
+version = '1.2'
 
 setup(name='plone.app.kss',
       version=version,