Pardon the top-posting, but I wanted to take André's helpful reply about getting started in contributing doc improvements (below) and then respond to/expand upon it.
Since it really is an entirely different subject than the OP's intent for the original thread, I have started this new one. (And this is my first time changing the subject line like that, mid-discussion, here on this list. So if that’s wrong either technically or per community standards, just let me know.) So first, here is what André had written to me, for context, then my reply is below. > -----Original Message----- > From: André Warnier (tomcat) <a...@ice-sa.com> > Subject: Re: On Tomcat 8.5.16, RemoteHostFilter throwing ServletException the > property [allow] is not defined > > On 29.03.2018 23:36, charlie arehart wrote: > > (And as I said in another thread, I don't propose these changes as if > > to say to someone, "now go do it". I'm saying it as someone who would > > try to step in and help, if permitted.) > > I think that you can do that. > Have a look here : > http://tomcat.apache.org/getinvolved.html > You have already done the first step. > You can do the second step, whenever you want : if you see a question to > which you can contribute a useful response, please do. > The next step would be the FAQ or Wiki. That's also fairly easy : go to > https://wiki.apache.org/tomcat/FrontPage > and see the "If you do decide to contribute," paragraph. > (You could for example start by providing some additional examples, as a FAQ > article. And I am sure that with a simple request on this list, a link to > that FAQ could then be easily added to the main docs). > If you want to contribute directly by improving the docs, that gets a bit > more involved, because it requires downloading the code, submitting patches > etc. But it can be done (I did it once, at a time when I wasn't even sure > what "diff" meant). > That will lead you here : http://www.apache.org/dev/contributors.html > (Note: the process for the documentation is exactly the same as for the code; > and as a contribution, it will be appreciated in the same way - or even more, > considering the inherent aversion of programmers toward documentation..) And > the ultimate reward (after a few years of hard and consciencious work) would > be here : > http://tomcat.apache.org/whoweare.html > Thanks very much for all that, André, and I have already started reading all the content about "the process". :-) A couple things flow from your suggestions there. 1) If you (or anyone following along and responsible for that FrontPage) are open to more feedback, your second step pointed me to the section there about, "If you do decide to contribute". The next words there say "you will need to create a Wiki login name", but it doesn't say how to do that. Now, sure, one might figure it out by thinking to click the login button at the top of the page, which then offers a link to create one. But it could be quite helpful if it just went ahead and offered that link under those words "create a Wiki login name", going to https://wiki.apache.org/tomcat/FrontPage?action=newaccount. :-) 2) Anyway, I did that, and the sentence then goes on to say that we should then send that new login name to the dev or users list, asking to be added to the ContributorsGroup. Now, I realize I should (and will) join the dev list also, but since the discussion has started here and may seem to come "out of left field" from me there, I will offer here that the login name is CharlieArehart. Let me know, folks involved, if you prefer I share that on the dev list instead for some reason (in which case, maybe that wording that says "or Tomcat Users" should be removed). As always, I'm just trying to help, not to criticize. 3) And to your final points, yep, I would be only interested in contributing to the docs (and happily) but not code. I truly am just a user of Tomcat--and other Java app servers. Though I've helped people troubleshoot issues with them for 10+ years, I've not written a line of production Java code since before then, so I won't be nearly as helpful with that! And I do see (from Mark's link to the doc repo, in another doc-related thread yesterday) that the project uses SVN. I'll start getting my head back into that (vs Git) in the meantime. :-) 4) Finally, thanks for the link to the whoweare page. That was helpful. I see now that you and Mark, who had been contributing on this thread, as well as you both and Christopher and Felix who were participating in my other thread about doc contribution, are all committers. Thanks very much for all you guys (and others here) do. Again, I just want to help, as a long-time user. I'm also a voracious reader of docs, and love to help others leverage them, and so I do often see opps for improvement in them. Of course, I appreciate that not every suggestion would be universally appreciated, and so I trust that the committers would help temper my enthusiasm where needed, such that I remain "more helpful than not". :-) Looking forward to getting involved. /charlie --------------------------------------------------------------------- To unsubscribe, e-mail: users-unsubscr...@tomcat.apache.org For additional commands, e-mail: users-h...@tomcat.apache.org
