carehart opened a new pull request, #9:
URL: https://github.com/apache/tomcat-connectors/pull/9

   Folks, are you ok with accepting PRs for doc improvements this way? The 
[page discussing doc 
contributions](https://tomcat.apache.org/connectors-doc/miscellaneous/doccontrib.html)
 proposes many more steps (including "building" the docs), but is it really 
necessary for us just to propose simple textual changes like in this PR?
   
   1) I do appreciate that this page I'm proposing correcting is perhaps the 
least important (as it's an old proposal that has barely changed in over a 
dozen years), but it IS listed on the left nav bar of [the connector docs 
pages](https://tomcat.apache.org/connectors-doc/). So people coming to the docs 
will see it, and could appreciate the page's typo and grammar errors being 
addressed.
   
   2) Indeed, I've wanted to propose those for other pages in the docs, and 
I've always been discouraged given the build process, when I'd just be 
proposing wording changes. 
   
   I found this section of the connector repo with the docs, and I'm hoping you 
may be open to at least considering proposed doc changes this way.  
   
   3) Finally, I appreciate that some github repo maintainers have their 
preferences, perhaps not even caring for PRs "out of the blue". I didn't find 
an option here in this github repo to open an issue. And I'm hoping you 
wouldn't require we open a discussion thread in one of the lists, just to make 
such typo proposals. But I'm interested to hear if you'll prefer something 
other than what I've done here.
   
   I really am just trying to help.


-- 
This is an automated message from the Apache Git Service.
To respond to the message, please log on to GitHub and use the
URL above to go to the specific comment.

To unsubscribe, e-mail: dev-unsubscr...@tomcat.apache.org

For queries about this service, please contact Infrastructure at:
us...@infra.apache.org


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

Reply via email to