-----BEGIN PGP SIGNED MESSAGE-----
Hash: SHA256

David,

On 7/18/14, 4:07 PM, David kerber wrote:
> On 7/18/2014 3:56 PM, Leo Donahue wrote:
>> On Sun, Jul 13, 2014 at 10:23 PM, Leo Donahue 
>> <donahu...@gmail.com> wrote:
>> 
>>> 
>>> I found a link on the web that mentioned something about 
>>> picking and choosing about 7 different jar files
>>> 
>>> 
>> Essentially that information is wrong.
>> 
>> Reading the manual here: 
>> https://jax-ws.java.net/2.2.8/docs/ch02.html#installation-instructions
>>
>>
>>
>> 
I needed all of them apparently.
>> 
>> Why does technology suffer from such poor documentation? Are 
>> medical books wrong? - errata... oh wait, I meant cut here! on 
>> page 1291  (that's going to leave a scar)

We are at a different place in history with regard to (software)
technology than, say, surgery. You can find lots of old books that
instruct physicians to do absolutely awful things to people like drill
holes in their skulls to let demons out. Everybody knows that's not a
good idea, so nobody does it anymore. Those old books have old
publication dates, aren't found in up-to-date libraries, etc.

The problem with the web is that nobody bothers curating anything, and
it's hard to determine the age of a piece of information.

>> Are mystery novel endings wrong? - errata... oh wait that person 
>> was supposed to live, not die on page 674 Why so much junky 
>> documentation in technology? This was a rhetorical question 
>> section.
> 
> Usually the problem is that the stuff you're reading wasn't
> written by the people who developed the program you're using.
> Particularly an issue with open source stuff where people take (for
> example) Tomcat and use it as part of another package, making
> modifications along the way, so that what they do only applies to
> their package. But people like you come along and don't know that
> it is only correct for their specific package.

Then, there's the problem of documenting something once and never
updating it.

To wit:
http://commons.apache.org/proper/commons-logging/troubleshooting.html#Apache_Tomcat

"At the current date, Tomcat 5.5.16 is the current release"

Note that the page advertises "Last Published: 09 July 2014" but that
has nothing to do with the date of last full review.

- -chris
-----BEGIN PGP SIGNATURE-----
Version: GnuPG v1
Comment: GPGTools - http://gpgtools.org
Comment: Using GnuPG with Thunderbird - http://www.enigmail.net/

iQIcBAEBCAAGBQJTyZrdAAoJEBzwKT+lPKRYeFMP/3M5+bEbhc1FAoUPIApJYADe
YtCIi9zy9Xtdhl34tYH8W18MOt2emcc9L3rBDBEAFoLoq3a08e/66wSOLSBjHoN0
UyZC58OIoEV6tgTB7KkCK/XXdWMhzDOnmUIdR5ffSdKuD8QS5Bz4h0unwc0jmAPd
Sxg3/xJIbWM7zfhW7pUcw6lC5d7gA/pA2cUdgoWtSoNxEkJy4x/pkLymVsT8Kgw+
oB3ZfV31zm44kMksQIA2X3Oe1HkMiCUpquWXJ5wEhOSYiDa6dMPCmjDFTQHYdVLw
+J8lbUZVT9fRSZzsVbD3kHonO63JzeEi0MYkVhNlUqJJS8VYb8+fsxdiOM+jl561
f6t5d8f7Pi9d0nkNJ+TXL6dhYaTL8Q6vnTNfcA/LmxHjD2Heh3tW/8PpGnDHMLll
XxI2lK8u/8j907hiK4j5xMawD2rwkDp6ckD4AQFNthfoz3uyZqhF3XQ5ZzeJVl3a
/WEVKSf+18Qt4qid252ufI1Z2Sen4wMb9obE8O5PpXN4Wsh11aGMNEssKXBjBgc7
xrlOD6RXdefZ99AvLEXWp4W6udhbhH69Mnza3PhSL+dMol4jRYJl9uSzaaeT8OFo
jwOTWLAAd468B8CSD4UCxBwO12jvEXYIznDiks8v0w95wg97kVKq0wkqCpqBrq6R
WpMxxnWUEQbTY39lIDaQ
=Cmqd
-----END PGP SIGNATURE-----

---------------------------------------------------------------------
To unsubscribe, e-mail: users-unsubscr...@tomcat.apache.org
For additional commands, e-mail: users-h...@tomcat.apache.org

Reply via email to