From 3d837680392d70329d43e93bbd03ade4d24ac020 Mon Sep 17 00:00:00 2001 From: Trustin Lee Date: Fri, 14 Nov 2008 06:32:10 +0000 Subject: [PATCH] Documentation cleanup --- src/docbook/module/preface.xml | 26 +++++++++++++------------- 1 file changed, 13 insertions(+), 13 deletions(-) diff --git a/src/docbook/module/preface.xml b/src/docbook/module/preface.xml index 950f6e54e3..4520486dee 100644 --- a/src/docbook/module/preface.xml +++ b/src/docbook/module/preface.xml @@ -6,21 +6,21 @@ Preface - The most fundamental question, What is Netty and why should I - care?, will be answered here. + This guide provides an introduction to Netty + and what it is about.
The Problem - We are using a general purpose application or library to communicate - with each other nowadays. For example, we often use an open source - HTTP client library to retrieve information from an open source web - server and to invoke a remote procedure call via web services. + Nowadays we use general purpose applications or libraries to communicate + with each other. For example, we often use an open source HTTP client + library to retrieve information from an open source web server and to + invoke a remote procedure call via web services. However, a general purpose protocol or its implementation sometimes - doesn't scale very well. It's like we don't use a general purpose + does not scale very well. It is like we don't use a general purpose HTTP server to exchange huge files, e-mail messages, and near-realtime messages such as financial information and multiplayer game data. What's required is a highly optimized protocol implementation which is @@ -54,7 +54,7 @@ programming such as TCP/IP socket server development. - 'Quick and easy' doesn't mean that a resulting application will suffer + 'Quick and easy' does not mean that a resulting application will suffer from a maintainability or a performance issue. Netty has been designed carefully with the experiences earned from the implementation of a lot of protocols such as FTP, SMTP, HTTP, and various binary and text-based @@ -63,14 +63,14 @@ without a compromise. - Some of you might already have found other network application + Some users might already have found other network application framework that claims to have the same advantage, and you might want to ask what makes Netty so different from them. The answer is the - philosophy where it is built on. It's designed to give you the most + philosophy where it is built on. Netty is designed to give you the most comfortable experience both in terms of the API and the implementation - from the day one. It's not something tangible but you will get to - realize that this philosophy will make your life much easier as you - read this guide on and play with Netty. + from the day one. It is not something tangible but you will realize that + this philosophy will make your life much easier as you read this guide + and play with Netty.