You are viewing a plain text version of this content. The canonical link for it is here.
Posted to dev@tomcat.apache.org by Christopher Schultz <ch...@christopherschultz.net> on 2018/09/14 20:27:03 UTC

Do we still need appweb/installation.html?

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

All,

This page is ... seriously out of date and probably need editing to
make it useful.

http://tomcat.apache.org/tomcat-9.0-doc/appdev/installation.html

First, it implies that a JDK is required to install Tomcat. Not really
/Tomcat/ per se, since this is the "how to develop applications on
Tomcat" section of the user's guide, but it still seems like the JDK
is a prerequisite for Tomcat itself, rather than a prerequisite for
writing your own applications.

Also, it's false: you can develop and deploy a Tomcat application
without a JDK, as long as you don't need to compile your own .java
files (e.g. pure-JSP is possible).

Second, it mentions CVS as a revision-control system.

ASF has moved one and a half times (some now use git) since using CVS.
Should we really have to tell programmers they need RCS's anymore?

Finally, it's not even linked-to from the top-level documentation. I'm
not even sure how to get to the /appdev/ folder in the documentation.

While we are at it: should
http://tomcat.apache.org/tomcat-9.0-doc/developers.html exist anymore,
either? It's out of sync with http://tomcat.apache.org/whoweare.html
and has been for a very long time.

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

iQIzBAEBCAAdFiEEMmKgYcQvxMe7tcJcHPApP6U8pFgFAlucGZcACgkQHPApP6U8
pFjX4RAAr5+4ddxwAgXYInMiiiN8JuwhOSgmRnNXU+EI9wVtlI30B7V5dpnkt+dM
OJrmwERFi4+cESMyxMjoXSGPfJeB/skRm8WQ3+YaIWylZNipPFGlUqbj0mAarcqZ
CHMVu+/2f8C1Mn9MdfV38rlBvrieQlzEXekBo7LHQv7448eNrG1/Zk3viNcHBY7C
jk4wdL9PY3AS/iu/K5UsqrKJPg/Lunwog8bbd1kNbhTfFDEsE7mJBQ0xz378QzyW
f0EjBr07cer9OJsPgrl1rNLac2+bpezzKzhYzzlxG+1C9Oi5Cfdi/MDTEQbwNQeL
YRKlSZdDyX/y5+W8/VevS6MFYfbpdoTFaRQkPdbBPZP3AxQ+Dv06qqXpsazcS6Ak
XF5jXTUc/D3G75WsfkFNzyT/o97x0nmHK153/FNY5OxXRK46smwmog7vSCAGcCiy
7tcC3lWIx+yvBne9v7bxuqjg7qEwS97rEk9SS3hxXdzrMuJJOAKpDF4VevjCrUMM
hHTvoY50lrCrQYGrIapj9WRHBR8EKqbnswQKhXUshj9Dv5SYOXNVNMJLqZQUArRa
b8CToFwqdWIlGobvWLMzbzNPaMPEknS4fGZurpU1gf+ZHUKgCOyXanax4uU8dSMm
yLn1UKB2ok8bSBv/Lm4GIcJ61sBlPsx7+ny0/ph9MrjXx8ZKJS8=
=OXor
-----END PGP SIGNATURE-----

---------------------------------------------------------------------
To unsubscribe, e-mail: dev-unsubscribe@tomcat.apache.org
For additional commands, e-mail: dev-help@tomcat.apache.org

Re: Do we still need appweb/installation.html?

Posted by Mark Thomas <ma...@apache.org>.

On 14/09/2018 21:27, Christopher Schultz wrote:
> -----BEGIN PGP SIGNED MESSAGE-----
> Hash: SHA256
> 
> All,
> 
> This page is ... seriously out of date and probably need editing to
> make it useful.
> 
> http://tomcat.apache.org/tomcat-9.0-doc/appdev/installation.html
> 
> First, it implies that a JDK is required to install Tomcat. Not really
> /Tomcat/ per se, since this is the "how to develop applications on
> Tomcat" section of the user's guide, but it still seems like the JDK
> is a prerequisite for Tomcat itself, rather than a prerequisite for
> writing your own applications.
> 
> Also, it's false: you can develop and deploy a Tomcat application
> without a JDK, as long as you don't need to compile your own .java
> files (e.g. pure-JSP is possible).
> 
> Second, it mentions CVS as a revision-control system.
> 
> ASF has moved one and a half times (some now use git) since using CVS.
> Should we really have to tell programmers they need RCS's anymore?

I wouldn't be against removing that entirely. There must be better 
on-line guides we could link to.

> Finally, it's not even linked-to from the top-level documentation. I'm
> not even sure how to get to the /appdev/ folder in the documentation.

There is a link in webapps/docs/index.html

> While we are at it: should
> http://tomcat.apache.org/tomcat-9.0-doc/developers.html exist anymore,
> either? It's out of sync with http://tomcat.apache.org/whoweare.html
> and has been for a very long time.

I'm never a fan of duplication. +1 to removal.

Mark


> 
> - -chris
> -----BEGIN PGP SIGNATURE-----
> Comment: GPGTools - http://gpgtools.org
> Comment: Using GnuPG with Thunderbird - https://www.enigmail.net/
> 
> iQIzBAEBCAAdFiEEMmKgYcQvxMe7tcJcHPApP6U8pFgFAlucGZcACgkQHPApP6U8
> pFjX4RAAr5+4ddxwAgXYInMiiiN8JuwhOSgmRnNXU+EI9wVtlI30B7V5dpnkt+dM
> OJrmwERFi4+cESMyxMjoXSGPfJeB/skRm8WQ3+YaIWylZNipPFGlUqbj0mAarcqZ
> CHMVu+/2f8C1Mn9MdfV38rlBvrieQlzEXekBo7LHQv7448eNrG1/Zk3viNcHBY7C
> jk4wdL9PY3AS/iu/K5UsqrKJPg/Lunwog8bbd1kNbhTfFDEsE7mJBQ0xz378QzyW
> f0EjBr07cer9OJsPgrl1rNLac2+bpezzKzhYzzlxG+1C9Oi5Cfdi/MDTEQbwNQeL
> YRKlSZdDyX/y5+W8/VevS6MFYfbpdoTFaRQkPdbBPZP3AxQ+Dv06qqXpsazcS6Ak
> XF5jXTUc/D3G75WsfkFNzyT/o97x0nmHK153/FNY5OxXRK46smwmog7vSCAGcCiy
> 7tcC3lWIx+yvBne9v7bxuqjg7qEwS97rEk9SS3hxXdzrMuJJOAKpDF4VevjCrUMM
> hHTvoY50lrCrQYGrIapj9WRHBR8EKqbnswQKhXUshj9Dv5SYOXNVNMJLqZQUArRa
> b8CToFwqdWIlGobvWLMzbzNPaMPEknS4fGZurpU1gf+ZHUKgCOyXanax4uU8dSMm
> yLn1UKB2ok8bSBv/Lm4GIcJ61sBlPsx7+ny0/ph9MrjXx8ZKJS8=
> =OXor
> -----END PGP SIGNATURE-----
> 
> ---------------------------------------------------------------------
> To unsubscribe, e-mail: dev-unsubscribe@tomcat.apache.org
> For additional commands, e-mail: dev-help@tomcat.apache.org
> 

---------------------------------------------------------------------
To unsubscribe, e-mail: dev-unsubscribe@tomcat.apache.org
For additional commands, e-mail: dev-help@tomcat.apache.org