Inserting the description of the project that was missing. Others please complete both this file and project-info.xml.

git-svn-id: https://svn.apache.org/repos/asf/jakarta/poi/trunk@352213 13f79535-47bb-0310-9956-ffa450edef68

1 files changed, 27 insertions, 3 deletions

diff --git a/README.txt b/README.txt
index e34c84ae75..3037a2c4d2 100755
--- a/README.txt
+++ b/README.txt
@@ -7,9 +7,33 @@
   What is it?
   -----------
 
-
-
-
+  The POI project consists of APIs for manipulating various file formats 
+  based upon Microsoft's OLE 2 Compound Document format using pure Java.
+  
+  A common misconception is that POI writes Excel files. POI is the name 
+  of the project. 
+  POI contains several components, one of which, HSSF, writes Excel files. 
+  The following are components of the entire POI project.
+  
+    POIFS 
+    -----
+    The oldest and most stable part of the project. 
+    It is our port of the OLE 2 Compound Document Format to pure Java. 
+    It supports both read and write functionality. 
+    All of our components ultimately rely on it by definition. 
+  
+    HSSF
+    ----- 
+    It's our port of the Microsoft Excel 97(-2002) file format (BIFF8) 
+    to pure Java. It supports read and write capability. 
+  
+    HDF 
+    ---
+    It's our port of the Microsoft Word 97 file format to pure Java. 
+    It supports read and write capability. 
+    This component is in the early stages of design. 
+    Jump in! 
+   
   Where is it?
   ------------