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

2018-09-15 Thread Mark Thomas




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-unsubscr...@tomcat.apache.org
For additional commands, e-mail: dev-h...@tomcat.apache.org



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



Do we still need appweb/installation.html?

2018-09-14 Thread Christopher Schultz
-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-unsubscr...@tomcat.apache.org
For additional commands, e-mail: dev-h...@tomcat.apache.org