2001-09-20 Miguel de Icaza <miguel@ximian.com>

[mono.git] / web / documentation

diff --git a/web/documentation b/web/documentation
index f2286c5b5b6e041608691ac00b5109992ed6dcf5..166e0e8ccfe90d1d225b47e08a43eb78a0f70a6a 100644 (file)
--- a/web/documentation
+++ b/web/documentation
@@ -1,33 +1,31 @@
 * Documentation
 
-       A project like Mono will require a lot of documentation to be
-       written.  Although most of the concepts from Microsoft.NET can
-       be applied to the Mono platform once finished, we do need to
-       have a complete set of free documentation written for it.
+       Although most of the concepts from Microsoft.NET can
+       be applied to the completed Mono platform, we do need to
+       have a complete set of free documentation written specifically
+       for Mono.
 
-       The documentation license we have chosen is the FSF FDL which
-       is the standard for most documents on the free software
-       world. 
+       The documentation license we have chosen is the GNU Free
+       Documentation License (FDL), the standard for most documents
+       in the free software world. 
 
-       We need documentation to be written on a number of topics:
+       We need documentation on a number of topics:
 
        <ul>
 
                * The development tools (compilers, assembler tools,
                  language reference, design time features).
 
-               * Freely redistributable Frequently Asked Question
-                 compilations.
+               * Frequently Asked Question compilations.
 
-               * Freely redistributable HOWTO documents.
+               * HOWTO documents.
 
                * The Class Libraries
 
-               * Tutorials on Mono and the specifics of running it
-                 compared to the Microsoft.NET Framework SDK
+               * Tutorials on Mono and the specifics of running it. 
 
-               * Differences between the Microsoft.NET Framework SDK
-                 development mode and the Mono version.
+               * A guide to Mono as compared to the Microsoft.NET
+                 Framework SDK
 
        </ul>
 
@@ -40,11 +38,13 @@
 
        If you provide examples, please do not embed them into the
        source code, as that will make the source code harder to read
-       and maintain.  Instead put examples for your code into a
-       subdirectory of the class libraries.  Also make that sample
-       code a full standalone application that people can compile
-       (ideally our documentation browser could let you edit, modify
-       and run the sample programs, as Tcl/Tk used to let you do in
-       the past).
+       and maintain.  Instead, put examples for your code into a
+       subdirectory of the class libraries. Make your sample
+       code a full standalone application that people can compile.
+       Ideally the Mono documentation browser will let you edit, modify
+       and run the sample programs.
+
+
+