Questions on the contribution process

2021-05-20 Thread Neale Rudd

Hi All,

I am currently working on a new catalina filter for Tomcat.

I will submit my ideas and code for discussion using Bugzilla.

While I was able to find the style guide and submissions guide, I still 
have a few questions about the process:


- Romain has pointed me to 
https://github.com/apache/tomcat/blob/master/webapps/docs/config/filter.xml 
for adding a documentation diff, so I think I have that covered


- should I submit a separate javax and jakarta version or is someone in 
charge of backports?


- is there a way to generate the javadoc for the class?ᅡᅠ I can't see 
comments above the functions in the other filters, so is this manually 
written in HTML or is there a file which automatically generates it 
separate to the source code?ᅡᅠ For example, how is 
https://tomcat.apache.org/tomcat-8.0-doc/api/org/apache/catalina/filters/HttpHeaderSecurityFilter.html 
created?


- is there anything else which I should be submitting along with the new 
class?


I couldn't find the answers to these questions in the submission 
guidelines so I'm asking here.


It may also be helpful if the answers were added to the submission guide 
page for other new contributors to avoid them asking the same questions.


Thanks for your help,
Neale Rudd
metawerx.net


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



A thank you to the devs

2021-05-12 Thread Neale Rudd

To the great Tomcat Devs,

tl;dr - This isn't a question, just a praise email.

Firstly, I want to say that I really appreciate all the hard work you 
have all put in to this project over the years.


We are a small company but have been hosting Tomcat since version 3 (we 
started on ServletExec in 1997), we were the first Australian Java Host 
and now we're the only one exclusively hosting Java in Australia.ᅡᅠ 
Tomcat is lean, fast, secure, continually updated and friendly to use.ᅡᅠ 
It's kept our customers very happy ever since we started providing it.


Our wiki on web.xml is listed on GAE as the main reference for web.xml, 
above the offical Servlet Spec at 
https://cloud.google.com/appengine/docs/standard/java/config/webxml - it 
could do with an update ;-)ᅡᅠᅡᅠ You can find the GAE web.xml doc by 
searching for "google web.xml", it's always the first link.ᅡᅠ If anyone 
has any new element docs to add I'm happy to add your name as a 
contributor in the comments.


As for Tomcat itself, I've only suggested a couple of changes over the 
years:


- catalina.policy change for when catalina.home and catalina.base are 
different, which was accepted and is in catalina.policy from 7 to 10


- one regarding an error in the DIGEST authentication which was also 
accepted and subsequently improved upon by Mark, in Tomcat 7.


I hope to contribute more in the future but I rarely find any problems.ᅡᅠ 
I'm also in contact with a dev from the TomEE team who has been great 
too and hosts his blog with us.


Today we've been published in an article and I've tweeted about it and 
made special thanks to Tomcat, TomEE, Ubuntu and MySQL for all for your 
great work.


https://twitter.com/metawerx/status/1392484462382903298

Anyway, I just wanted to thank and commend you all on your great, 
tireless and often under-appreciated work on Tomcat, the best container 
ever and any other open source projects or libraries you have been 
involved in.ᅡᅠ Without your hard work, the world would be stuck in the past.


Also, congratulations on the new Tomcat 10 going into production!

Best Regards,

Neale Rudd

Managing Director

metawerx.net



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