diff --git a/docs/TODO b/docs/TODO
new file mode 100644
index 00000000..0cbb7721
--- /dev/null
+++ b/docs/TODO
@@ -0,0 +1,57 @@
+*normal mode* :
+- add a PHP script that will generate dynamically all the files entity in manual.xml
+- add CDATA sections in all programlistings.
+- add roles to programlisting (especially role="php") and add PHP tags in PHP examples (short_open_tag is banned). This will help to :
+ -- colorize examples
+ -- check parse errors : for i in $(ls |grep xml); do php -d short_open_tag=off -l $i; done
+
+*pedentic mode* :
+- fix indenting in all .xml files : don't uses tabs, indent by a space. Here's a nice indentation :
+
+
+
+
+
+
+
+
+
+
+- clean all the examples :
+(if aggreed) examples should be XHTML compliant and should stick to PEAR's coding standards.
+
+Here's how a complete example, using PHP and templates, should be written :
+
+
+ html_image example
+
+display('index.tpl');
+
+?>
+]]>
+
+
+ where index.tpl is:
+
+
+
+
+
+ a possible output would be:
+
+
+
+]]>
+
+
+