Folks,
I started putting together a web site for Jakarta HttpComponents and
porting the project object model from Maven 1 to Maven 2.
I also found the new APT (Almost Plain Text) format slightly easier for
writing documentation than xdoc.
I will be using APT for now unless someone complains. If someone feels
very strongly against APT or in favor of a different format, please make
your opinion known now.
To unsubscribe, e-mail: httpclient-dev-unsubscribe (AT) jakarta (DOT) apache.org
For additional commands, e-mail: httpclient-dev-help (AT) jakarta (DOT) apache.org

Hi ,

I think this is a great start. Attached are a few changes I made to
the goals-scope doc. than these wording mods I have a few
comments:

- I think we should add a section/module for HttpClient. Even if we
don't have an actual HttpClient based upon HttpComponents it would be
good to keep the name there for context and to indicate future
direction.
- The goals and scope page is good summary of what's wrong with
HttpClient, but it doesn't really feel like goals and scope. I
suggest we should have a section on goals that talks about what's
wrong with HttpClient (already have that), and then details more about
how we're going to fix the problems in HttpComponents (we have some of
that). As far as scope goes I'm not sure we need much. They key
points are covered in our charter I think (i.e. HttpClient, tools, not
competition for Tomcat).

Mike

2/25/06, Kalnichevski <olegk (AT) apache (DOT) orgwrote:
Folks,

This is the first preview of the HttpComponents web site:

http://people.apache.org/~

Please, take a quarter of an hour to review the content. Patches,
content contributions will be hugely appreciated. If you are not
familiar with Maven 2, feel free to submit stuff in plain text. I'll
happily do all the grunt work

Roland,

Would be able to write a short intro for the http-async module?

Henri,
Is there already any documentation for norobots-rfc you may want to
publish on the HttpComponents site?

--

To unsubscribe, e-mail: httpclient-dev-unsubscribe (AT) jakarta (DOT) apache.org
For additional commands, e-mail: httpclient-dev-help (AT) jakarta (DOT) apache.org
--

To unsubscribe, e-mail: httpclient-dev-unsubscribe (AT) jakarta (DOT) apache.org
For additional commands, e-mail: httpclient-dev-help (AT) jakarta (DOT) apache.org

Hi ,

good start indeed. Some minor suggestions:

[Description -Standards Compliance]
I would rephrase the sentence as "HttpComponents strives to conform to".
Never promise more than you can deliver :-)

In the menu for both modules, can you add a link to the main page
for HttpComponents? There is one to the right of the status line
(which doesn't work in the preview), but that is not where I would
normally look for it. current page also has a "Home" link that
takes you to the commons main page as the top item in the menu.

[HttpAsync -Description -]
The HttpAsync component provides an asynchronous interface for
client side HTTP communication, which seperates the sending of a
request from the receiving of the response. This simplifies
development of multithreaded HTTP applications and allows for
new features such as pipelining.

I agree with Mike that we should have a dummy module for HttpClient.
I also think we should have dummies for the other planned modules, in
particular HttpCookie and HttpAuth. It will help people to understand
which features are *not* to be expected in HttpCore.

Regarding goals and scopes, I divert from Mike's suggestion. Instead
of having a section that talks about HttpClient deficiencies and then
adds details on how we want to address them, I would prefer to
state goals and then add details about the HttpClient deficiencies
from which these goals are derived. Simply reversing the headlines
of the current page would already help:

[Componentized Design]
[Cleanly structured API]
[Minimal external dependencies]

instead of

[Monolithic design of Commons HttpClient]
[Inherent API deficiencies]
[External dependencies]

cheers,
Roland

To unsubscribe, e-mail: httpclient-dev-unsubscribe (AT) jakarta (DOT) apache.org
For additional commands, e-mail: httpclient-dev-help (AT) jakarta (DOT) apache.org

Sat, 2006-02-25 at 22:16 -0500, Michael Becke wrote:
Hi ,

I think this is a great start. Attached are a few changes I made to
the goals-scope doc. than these wording mods I have a few
comments:

Mike,

The attachment apparently got stripped. Do not be shy and just commit
the changes.
- I think we should add a section/module for HttpClient. Even if we
don't have an actual HttpClient based upon HttpComponents it would be
good to keep the name there for context and to indicate future
direction.

Agreed.
- The goals and scope page is good summary of what's wrong with
HttpClient, but it doesn't really feel like goals and scope. I
suggest we should have a section on goals that talks about what's
wrong with HttpClient (already have that), and then details more about
how we're going to fix the problems in HttpComponents (we have some of
that). As far as scope goes I'm not sure we need much. They key
points are covered in our charter I think (i.e. HttpClient, tools, not
competition for Tomcat).

Agreed. As soon as I pick up your changes I'll do some more work on the
goals page

Cheers,

Mike

2/25/06, Kalnichevski <olegk (AT) apache (DOT) orgwrote:
Folks,

This is the first preview of the HttpComponents web site:

http://people.apache.org/~

Please, take a quarter of an hour to review the content. Patches,
content contributions will be hugely appreciated. If you are not
familiar with Maven 2, feel free to submit stuff in plain text. I'll
happily do all the grunt work

Roland,

Would be able to write a short intro for the http-async module?

Henri,
Is there already any documentation for norobots-rfc you may want to
publish on the HttpComponents site?

--

To unsubscribe, e-mail: httpclient-dev-unsubscribe (AT) jakarta (DOT) apache.org
For additional commands, e-mail: httpclient-dev-help (AT) jakarta (DOT) apache.org
--

To unsubscribe, e-mail: httpclient-dev-unsubscribe (AT) jakarta (DOT) apache.org
For additional commands, e-mail: httpclient-dev-help (AT) jakarta (DOT) apache.org

To unsubscribe, e-mail: httpclient-dev-unsubscribe (AT) jakarta (DOT) apache.org
For additional commands, e-mail: httpclient-dev-help (AT) jakarta (DOT) apache.org

The attachment apparently got stripped. Do not be shy and just commit
the changes.

Patch committed.

Mike

To unsubscribe, e-mail: httpclient-dev-unsubscribe (AT) jakarta (DOT) apache.org
For additional commands, e-mail: httpclient-dev-help (AT) jakarta (DOT) apache.org

2/26/06, Roland Weber <http-async (AT) dubioso (DOT) netwrote:

I also think we should have dummies for the other planned modules, in
particular HttpCookie and HttpAuth. It will help people to understand
which features are *not* to be expected in HttpCore.

Yes, good idea. Might as well lay it all out and fill in when things are ready.

Regarding goals and scopes, I divert from Mike's suggestion. Instead
of having a section that talks about HttpClient deficiencies and then
adds details on how we want to address them, I would prefer to
state goals and then add details about the HttpClient deficiencies
from which these goals are derived. Simply reversing the headlines
of the current page would already help:

[Componentized Design]
[Cleanly structured API]
[Minimal external dependencies]

Yep, I like this better. I'll take a crack at it this afternoon if no
one beats me to it.

Mike

To unsubscribe, e-mail: httpclient-dev-unsubscribe (AT) jakarta (DOT) apache.org
For additional commands, e-mail: httpclient-dev-help (AT) jakarta (DOT) apache.org