Hello. I'm working on the following changes for Chapters 1 and 2:
* Revise Preface
Chapter 1:
* Revise sections 1.1 and 1.2, "What is Mono" and "What is .NET"?
* Delete Section 1.3, "History"
* Replace with Section 1.3, "Why Mono?"
Chapter 2:
haven't gotten there yet. Need to replace "Mono Implementation" with "Modules." Goal for all revisions is to be focused on Mono only-- C# and .NET in general have better docs elsewhere, as discussed in one of the appendices. Also, Appendix C (Presentations) should be merged into Appendix D, Additional Resources.
Anyone object? The attached diff is a pretty good idea of what sorts of changes i'm contemplating, content-wise... I'll get EDasque or someone to read it over for accuracy before I commit, of course.
Cheers!
? mono-docs-diff.txt
Index: en/index.html
===
RCS file: /mono/monkeyguide/html/en/index.html,v
retrieving revision 1.75
diff -u -r1.75 index.html
--- en/index.html 3 Feb 2004 05:10:54 - 1.75
+++ en/index.html 5 Apr 2004 22:14:20 -
@@ -22,14 +22,13 @@
1.1 What is .NET?
1.2 What is Mono?
- 1.3 Mono history
+1.3 Why Mono?
- CHAPTER 2 -
Architecture
+ CHAPTER 2 - Architecture
and Platform Support
2.1 .NET Framework
Architecture
- 2.2 Mono Implementation
- 2.3 Comparing Mono and the .NET Framework
- 2.4 Mono enabled platforms
+ 2.3 Comparing Mono and the Microsoft Implementation of .NET
+ 2.4 Supported Platforms
PART 2 - Installing Mono and
Choosing the IDE
@@ -205,11 +204,10 @@
A Code Samples used in the
document
B Sample
Applications
- C Presentations
- D Links to other
Resources
- E ECMA Standards
- F License
- G Credits
+ C Links to other
Resources
+ D ECMA Standards
+ E License
+ F Credits
Index: en/preface.html
===
RCS file: /mono/monkeyguide/html/en/preface.html,v
retrieving revision 1.15
diff -u -r1.15 preface.html
--- en/preface.html 11 Jan 2004 21:17:37 - 1.15
+++ en/preface.html 5 Apr 2004 22:14:20 -
@@ -12,17 +12,16 @@
-The Mono Handbook is a collection of guides and tutorials that
-should help you getting started with Mono. It covers the Mono
-runtime, the C# language, and tools like the debugger, certain parts of
-the class libraries, the Database layer ADO.NET, and the Website
-Framework ASP.NET, as well as Gtk#. It is not meant as the complete
-documentation of Mono.
+
-How to read this guide
+The Mono Handbook is a short introduction to the Mono runtime and tools like
+the debugger, some class libraries, and Gtk#. It does not cover C# or the
+basics of the .NET framework, nor does it constitute the complete documentation
+for Mono. Additional resources are listed in
+Appendix C, Links to other Resources.
+
+
-Beginners should probably read this guide in its entirety, but experts
-will probably only need to read about the information they don't know already.
Index: en/mono/dotnet.html
===
RCS file: /mono/monkeyguide/html/en/mono/dotnet.html,v
retrieving revision 1.16
diff -u -r1.16 dotnet.html
--- en/mono/dotnet.html 11 Jan 2004 21:17:37 - 1.16
+++ en/mono/dotnet.html 5 Apr 2004 22:14:20 -
@@ -7,63 +7,50 @@
-
+
What is .NET?
-.NET is a product family shipped by Microsoft in 2001 as a
-response to the successful Java from Sun and designed to
-better integrate the different development environments
-on windows like C++ and Visual Basic. From that perspective
-it's not a Java clone, but rather an approach to better solve the problems
-COM was supposed to solve with some exciting new features added like language
-independence, great Database support, broad XML support, well-designed
-WebServices and WebApplications support, and a big upgrade
-to the VisualBasic language, including better object orientation.
-
-The "Microsoft .NET" name means in fact 3 things. It is important not to confuse
-them.
-
-The .NET Framework
-Services (MyServices, Passport)
-Other things with the label ".NET"
-
-
-
-Mono is just a free implementation of the .NET Framework for Linux
-and other systems. The .NET Framework is a "software platform" similiar
-to Java. The technical aspect will be discussed in "Architecture".
-Language independence. Perhaps the most important factor
-is, that all languages "are created eval". Yes, that's the right
-word. There are not one or two languages that can be consumed by
-others, if you want language independence.
-