[
https://issues.apache.org/jira/browse/HTTPCLIENT-1201?page=com.atlassian.jira.plugin.system.issuetabpanels:comment-tabpanel&focusedCommentId=13287429#comment-13287429
]
Oleg Kalnichevski edited comment on HTTPCLIENT-1201 at 6/1/12 3:05 PM:
-----------------------------------------------------------------------
The tutorial includes a section on HTML form submissions in the 'fundamentals'
chapter. If you think the section is not well written (which may well be the
case) feel free to contribute a better one. The same goes for the rest of your
drivel. If you think something can be done better, submit a patch.
Oleg
[1]
http://hc.apache.org/httpcomponents-client-ga/tutorial/html/fundamentals.html#d5e180
was (Author: olegk):
The tutorial includes a section on HTML form submissions in the
'fundamentals' chapter. If you think the section is not well written (which may
well be the case) feel free to contribute a better one. The same goes for the
rest of your drivel. If you think something can be done better, submit a patch.
Oleg
[1]
http://hc.apache.org/httpcomponents-client-ga/tutorial/html/advanced.html#d5e1339
> provide basic documentation in an obvious place
> -----------------------------------------------
>
> Key: HTTPCLIENT-1201
> URL: https://issues.apache.org/jira/browse/HTTPCLIENT-1201
> Project: HttpComponents HttpClient
> Issue Type: Improvement
> Components: Documentation
> Affects Versions: 4.2 Final
> Reporter: miles zarathustra
>
> The only documentation obviously linked from the main HttpClient page is the
> "tutorial." This "tutorial" talks about a lot of esoteric arcane junk I
> don't care about, but gives no clue on how to send parameters via a basic
> post. For that, I have to go here:
> http://wiki.apache.org/HttpComponents/QuickStart
> It's very difficult to find, and it's a lot easier to google examples that
> don't work. I wound up trying 4 different purported solutions before I found
> this one that works. If you look around the web you'll notice that people
> generally find the httpclient documentation frustrating. I have colleagues
> who argue that it would be easier to just write the post logic from scratch
> than figure out how the silly apache stuff works, and it's difficult for me
> to contradict them.
> It would be SO easy to improve the situation by making links to already
> available examples of the basic operations in an obvious place.
> The FAQ that explains some things about WHY the posts work in the totally
> non-intuitive way that they do would be nice also.
> Thanks.
--
This message is automatically generated by JIRA.
If you think it was sent incorrectly, please contact your JIRA administrators:
https://issues.apache.org/jira/secure/ContactAdministrators!default.jspa
For more information on JIRA, see: http://www.atlassian.com/software/jira
---------------------------------------------------------------------
To unsubscribe, e-mail: [email protected]
For additional commands, e-mail: [email protected]
