Mark,
On 2/12/26 9:34 AM, Mark Thomas wrote:
On 12/02/2026 14:27, Christopher Schultz wrote:
All,
Reading some responses in the Tomcat 9.0 EOS (EOL?) announcement, I
think we may have a documentation problem.
For example, every item listed under "Downloads" on the web site has a
corresponding item under "Documentation" except for the Migration Tool
and Taglibs.
The existing documentation (assuming a user doesn't want to read code
or javadoc, etc.) is pretty much limited to two places:
1. The MT download page (https://tomcat.apache.org/download-
migration.cgi) which doesn't tell you ANYTHING about what it is
and
2. The GitHub README.md file (https://github.com/apache/tomcat-
jakartaee-migration/blob/main/README.md)
I propose that we add at least *something* to the public web site. Are
there any objections to me adding some documentation for MT?
The README.ms file is mostly about "how" and not" what" or "why". So
my proposal is to summarize what MT can do and how it can help you
migrate your project from Java EE to Jakarta EE so you can transition
from Tomcat 9 to Tomcat 10+.
+1
Are you thinking going this in the migration tool repo or directly in
the site repo?
I was thinking I would just put it into the web site repo. If you'd
prefer, I can built-out the infrastructure to put it into the tool repo
like it is with the individual Tomcat versions, but honestly that seems
like more work than necessary for something with (hopefully) a limited
lifespan.
Or maybe I could put that documentation directly into Tomcat itself, and
then just link to it from the web site? Long after Tomcat 9 support in
dropped, I suspect we will continue to include the Migration Tool in
Tomcat so maybe that's a better place to build the documentation.
-chris
---------------------------------------------------------------------
To unsubscribe, e-mail: [email protected]
For additional commands, e-mail: [email protected]
