I've pretty much finished replacing Kid with Genshi for directdocs (the project that generates the PyOpenGL documentation by combining the upstream docbook files with the pydoc-like introspection of PyOpenGL, as well as generating the OpenGLContext tutorial files).  Was pretty much painless. Caught for a bit on ${ [ do(x) for x in y] } operation not working as expected where do() is a py:def function; was returning generator objects in Genshi instead of producing text.  A few py:for tags solved that. Also spent a bit figuring out how to copy lxml-produced ETree nodes directly into the result;

<?python
from genshi.input import ET
?>

and then insert the elements with ${ET(element)}.