You are viewing a plain text version of this content. The canonical link for it is here.
Posted to users@tomcat.apache.org by charlie arehart <ch...@carehart.org> on 2018/03/27 22:05:07 UTC
How to offer a link correction for the Tomcat docs?
Greetings. I’m a new list member, though a fairly long-time Tomcat user.
I found a broken link in the Tomcat User Guide (8 and 7), on its left nav bar. How would I best go about reporting such a broken link in the Tomcat docs?
To be clear, while there is a comments section at the bottom of the doc pages, that points folks to https://tomcat.apache.org/tomcat-8.0-doc/comments.html to learn more, which in turn points to https://comments.apache.org/help.html. But that gets a 503 service unavailable error. I find a jira discussion indicating this is a long-standing issue, which was hoped to be solved by now: https://issues.apache.org/jira/browse/INFRA-15947.
Until that’s resolved, is this or another TC list a good place to report such a broken link, or other doc suggestion? Thanks.
/charlie
Re: How to offer a link correction for the Tomcat docs?
Posted by Christopher Schultz <ch...@christopherschultz.net>.
-----BEGIN PGP SIGNED MESSAGE-----
Hash: SHA256
Charlie,
On 3/29/18 4:38 PM, charlie arehart wrote:
> Thanks. I'm guessing someone fixed it before you looked, as I see
> now that it is fixed as well. (And same for the 7 doc.)
It's possible there was a problem with a specific page, though I think
the build-process puts the same left-panel on every page. *shrug*
> Now, if you may be tempted to say that you don’t think anyone had
> changed it recently, I would just offer here a screenshot of the 8
> doc page, from the browser where I tripped over the problem (and
> which I had not reloaded since seeing your answer here). It clearly
> shows that it WAS wrong at some point. :-)
>
> cid:image003.jpg@01D3C773.EB0A17B0
Screenshots are stripped from the list. The conspiracy continues!
> And in case the image doesn’t make it through, here’s a dropbox
> link to it: https://www.dropbox.com/s/k9wivla0vwu91a1/
Looks photoshopped. :D
> I can’t imagine any way I’d see that in my browser other than if
> the link was indeed wrong in the HTML. In fact, I was able to do a
> view source and there is was:
>
> <li><a href="_means_-descriptors-howto.html">17) MBeans
> Descriptors</a></li>
>
> (But I realize that for some users it’s possible that the HTML I
> just pasted won’t show up.)
>
> As always, just trying to help.
Definitely thank you for bringing it to our attention, even if it was
already fixed or whatever. If you hadn't said something, maybe nobody
else would have.
I can't see any recent changes to the svn repo for those pages... I'm
not sure what the problem could have been.
- -chris
-----BEGIN PGP SIGNATURE-----
Comment: GPGTools - http://gpgtools.org
Comment: Using GnuPG with Thunderbird - http://www.enigmail.net/
iQIzBAEBCAAdFiEEMmKgYcQvxMe7tcJcHPApP6U8pFgFAlq9ZfMACgkQHPApP6U8
pFi6EA/5Ac4cwVnFsuPhhH2LWltSfEWt74GjG9XrO7+QVlBik5I8ycbGLIq8kl8l
xo9Nr8zQ0kn3gHeCZ1SU0kg54LrmsYFtSZ+mRuQLA+YMSBH218joqru9XRO8kyFE
rgyZgkb8KmfVosJs5s67WNo+7OBL/lbWatL2Qx5Ihbbfz3fRvRDgbTjwQZGB7c2e
V9RghcFiBfLsuF7k979GRq0vYfTAPWvWsG593N7Nr5y+xiOvtUkOuMbo4/MIn2Og
uEQ3YR6lo9IkjW3bhFr9Q3BS+vUJ/wyBQrTIF2oPsHIm5Ebb4aGYV5rPxfHwJN40
32zzlidI9kvlLF8vDrk0uqkXEKzRr5coIE6VBB2wgShHCBidFt/NW49a2588Oebz
CqTzXKEjgiWnbw6+WJUytYpbz/HcxspVwexOZTAJMWk4nkNyEe7k52rF2fSLGTxB
8TsNFutIWyzJn9iOVd3950k0ia3utHxdM/4d3P1+q+prMnSNfGYvB6VsR1FXIhPq
9/DSumizCx2BoVWOVYKEry50NAAT3MhRWpA7J52oLXCu7AoHbVk4q+bTz8zGjbOJ
7E7QTF486sYJwU7GSANqaj4VKFDTBrNdTPGxFIUsJ/NK3EjhI10yicbai3MpBTVm
HddDNYPj8w9QUhJ+Zd7moDW2ua5vvUAG3f2aJ8VT0dCIIyvwcJE=
=vVPM
-----END PGP SIGNATURE-----
---------------------------------------------------------------------
To unsubscribe, e-mail: users-unsubscribe@tomcat.apache.org
For additional commands, e-mail: users-help@tomcat.apache.org
RE: How to offer a link correction for the Tomcat docs?
Posted by charlie arehart <ch...@carehart.org>.
-----Original Message-----
> From: Felix Schumacher <fe...@internetallee.de>
>
> All changes to sources are send to the dev list, so I didn't feel the need to announce it independently. But as a
> small defence on my side, in my last mail to you on the user-owners, I wrote that I would probably have a look
> at it and thought that would be enough to inform you about it. Sorry, that I didn't send a follow up and didn't
> answer earlier to your follow-up on this list.
<snip>
> That is the reason, why I thought it a good idea to discuss this on the public users list.
>
> I still believe that your real concern is not about these few b's missing from links in the documentation, but
> rather how to report those mistakes in general, how to submit fixes in an easy way and most importantly: where
> is this written on the tomcat home page.
>
> And to address these things, I found it important, that you started this discussion on the mailing list. Those on
> the dev list mostly know how to contribute changes, but we also want newcomers to become contributors. Thus
> it is important, that we have a clearly described way on how to contribute at a prominent place on the home page.
>
> Best regards,
> Felix
Thanks, ok, and +1 to that, Felix. :-)
/charlie
---------------------------------------------------------------------
To unsubscribe, e-mail: users-unsubscribe@tomcat.apache.org
For additional commands, e-mail: users-help@tomcat.apache.org
Re: How to offer a link correction for the Tomcat docs?
Posted by Felix Schumacher <fe...@internetallee.de>.
Am Donnerstag, den 29.03.2018, 18:21 -0500 schrieb charlie arehart:
> >
> > From: Christopher Schultz <ch...@christopherschultz.net>
> >
> > Mark,
> >
> > On 3/29/18 6:07 PM, Mark Thomas wrote:
> > >
> > > On 29/03/18 21:38, charlie arehart wrote:
> > > >
> > > > Thanks. I'm guessing someone fixed it before you looked, as I
> > > > see now
> > > > that it is fixed as well. (And same for the 7 doc.)
> > > >
> > > > Now, if you may be tempted to say that you don’t think anyone
> > > > had
> > > > changed it recently,
> > > That is what version control is for:
> > > http://svn.apache.org/viewvc?rev=1827860&view=rev
> > >
> > > Felix made a bunch of changes to fix this of which the above
> > > change is
> > > just the first.
> > Aha. I even knew "where" I was looking and I still missed it.
> >
> > - -chris
> Well, FWIW, I will say that I did not know, Chris. :-)
>
> And to Mark, I would ask: how would I have known to look there? I
> don't mean to sound snarky, but I said in my very first post on the
> subject that I was new to the list (though not new to Tomcat, as a
> user at least).
>
> So mine is a sincere question: is there some way that I, as a mere
> use of the docs, would have even known that they were in that version
> control resource? Let alone what specific one? Are you thinking that
> there is some resource that readily tells us that, as users? If I
> missed it, I do apologize.
>
> Or might you just have thought that this was discussed often enough
> here that one should have known? Again, I admitted I was a new user,
> but perhaps you did not read that very first message. (No one replied
> for a few days, which is why I pinged about it again today.)
>
> And to that point, and indeed your observation that this was changed
> by Felix...well, he never said so here. Again, that's why I pinged
> the list on this. I do appreciate that it was done, of course! And
> also that (like Andre said in another thread today) doing doc changes
> is a thankless enough task. :-) I'm just saying a lot of back and
> forth could have been saved. Browser caching of the page clearly kept
> me from seeing the change on my own.
All changes to sources are send to the dev list, so I didn't feel the
need to announce it independently. But as a small defence on my side,
in my last mail to you on the user-owners, I wrote that I would
probably have a look at it and thought that would be enough to inform
you about it. Sorry, that I didn't send a follow up and didn't answer
earlier to your follow-up on this list.
>
> And again, I am trying to learn the ins and outs here, so as not to
> be a burden to the list. I hope ultimately to "give" far more than
> "take", over time, if I can (as I've done for many years in other
> forums and lists).
That is the reason, why I thought it a good idea to discuss this on the
public users list.
I still believe that your real concern is not about these few b's
missing from links in the documentation, but rather how to report those
mistakes in general, how to submit fixes in an easy way and most
importantly: where is this written on the tomcat home page.
And to address these things, I found it important, that you started
this discussion on the mailing list. Those on the dev list mostly know
how to contribute changes, but we also want newcomers to become
contributors. Thus it is important, that we have a clearly described
way on how to contribute at a prominent place on the home page.
Best regards,
Felix
>
>
> ---------------------------------------------------------------------
> To unsubscribe, e-mail: users-unsubscribe@tomcat.apache.org
> For additional commands, e-mail: users-help@tomcat.apache.org
>
---------------------------------------------------------------------
To unsubscribe, e-mail: users-unsubscribe@tomcat.apache.org
For additional commands, e-mail: users-help@tomcat.apache.org
RE: How to offer a link correction for the Tomcat docs?
Posted by charlie arehart <ch...@carehart.org>.
> From: Christopher Schultz <ch...@christopherschultz.net>
>
> Mark,
>
> On 3/29/18 6:07 PM, Mark Thomas wrote:
> > On 29/03/18 21:38, charlie arehart wrote:
>>> Thanks. I'm guessing someone fixed it before you looked, as I see now
>>> that it is fixed as well. (And same for the 7 doc.)
>>>
>>> Now, if you may be tempted to say that you don’t think anyone had
>>> changed it recently,
>>
>> That is what version control is for:
>> http://svn.apache.org/viewvc?rev=1827860&view=rev
>>
>> Felix made a bunch of changes to fix this of which the above change is
>> just the first.
>
>Aha. I even knew "where" I was looking and I still missed it.
>
>- -chris
Well, FWIW, I will say that I did not know, Chris. :-)
And to Mark, I would ask: how would I have known to look there? I don't mean to sound snarky, but I said in my very first post on the subject that I was new to the list (though not new to Tomcat, as a user at least).
So mine is a sincere question: is there some way that I, as a mere use of the docs, would have even known that they were in that version control resource? Let alone what specific one? Are you thinking that there is some resource that readily tells us that, as users? If I missed it, I do apologize.
Or might you just have thought that this was discussed often enough here that one should have known? Again, I admitted I was a new user, but perhaps you did not read that very first message. (No one replied for a few days, which is why I pinged about it again today.)
And to that point, and indeed your observation that this was changed by Felix...well, he never said so here. Again, that's why I pinged the list on this. I do appreciate that it was done, of course! And also that (like Andre said in another thread today) doing doc changes is a thankless enough task. :-) I'm just saying a lot of back and forth could have been saved. Browser caching of the page clearly kept me from seeing the change on my own.
And again, I am trying to learn the ins and outs here, so as not to be a burden to the list. I hope ultimately to "give" far more than "take", over time, if I can (as I've done for many years in other forums and lists).
---------------------------------------------------------------------
To unsubscribe, e-mail: users-unsubscribe@tomcat.apache.org
For additional commands, e-mail: users-help@tomcat.apache.org
Re: How to offer a link correction for the Tomcat docs?
Posted by Christopher Schultz <ch...@christopherschultz.net>.
-----BEGIN PGP SIGNED MESSAGE-----
Hash: SHA256
Mark,
On 3/29/18 6:07 PM, Mark Thomas wrote:
> On 29/03/18 21:38, charlie arehart wrote:
>> Thanks. I'm guessing someone fixed it before you looked, as I see
>> now that it is fixed as well. (And same for the 7 doc.)
>>
>> Now, if you may be tempted to say that you don’t think anyone
>> had changed it recently,
>
> That is what version control is for:
> http://svn.apache.org/viewvc?rev=1827860&view=rev
>
> Felix made a bunch of changes to fix this of which the above change
> is just the first.
Aha. I even knew "where" I was looking and I still missed it.
- -chris
-----BEGIN PGP SIGNATURE-----
Comment: GPGTools - http://gpgtools.org
Comment: Using GnuPG with Thunderbird - http://www.enigmail.net/
iQIzBAEBCAAdFiEEMmKgYcQvxMe7tcJcHPApP6U8pFgFAlq9ZqYACgkQHPApP6U8
pFgv0xAAhLSrvrTYzA7DNXZyy5urQX8+02dY0hs/yHYSSqmLBIqNmKEnFwh13JXR
kg/gP5omvtxMsXK7TqzM7d7ar/o7z0+B9BtKNYSfAnkoWQ/TSePAEP6Xy9UF28yu
djQbCyXeKhlznx1VajlSNiVnWYuHZI/EGMAWRTWTwRpm0WpLjAPekXvvYEY1UCRU
0w6Zmdnpeb80+YwxxtFeLZnNl+nv+O6lAR59hl4nWahp722fmkBNQY2Tk2Zj0nXA
gYKs+nVwHp1hS7mrr3nKFX3Pu1vzRYu9iGr6oADTwB/zOPQcC9vqCXZjAnnuR9tP
MGuRzpZbg3F7DZM/58Qn3vACKHJlZj1Rumyc/o2w5mT3JK8pGE0QoYuEov9NuqQ/
8u6pJhvaajhYcZlk8BJxc3+QSOArgESdKo9YcTqa9gNlHahY+YVvSbXi9KRISFxE
1G/5ShWUOo15roWoKPDC8mWrzkKMcVBFwAojcpywp9uA0lYha0VV3wmEsrngIuuB
TReyWCpjbR2M7kc1f3ifpMOVXHpf8wDvmEJemYFVxJ/ovpvnKsaykMx5ZJnLk2vH
q7bKIFunUVVjBK109lJgYnTjgBZHaGubBZXuDTco0wApH58+AguhmgwEdlMVjDLK
U5ra0IVPk1eZ+hvc+utnY31+YiHRAqj3kc8PGJjnWrZg/56TAAA=
=V+dd
-----END PGP SIGNATURE-----
---------------------------------------------------------------------
To unsubscribe, e-mail: users-unsubscribe@tomcat.apache.org
For additional commands, e-mail: users-help@tomcat.apache.org
Re: How to offer a link correction for the Tomcat docs?
Posted by Mark Thomas <ma...@apache.org>.
On 29/03/18 21:38, charlie arehart wrote:
> Thanks. I'm guessing someone fixed it before you looked, as I see now
> that it is fixed as well. (And same for the 7 doc.)
>
> Now, if you may be tempted to say that you don’t think anyone had
> changed it recently,
That is what version control is for:
http://svn.apache.org/viewvc?rev=1827860&view=rev
Felix made a bunch of changes to fix this of which the above change is
just the first.
Mark
---------------------------------------------------------------------
To unsubscribe, e-mail: users-unsubscribe@tomcat.apache.org
For additional commands, e-mail: users-help@tomcat.apache.org
RE: How to offer a link correction for the Tomcat docs?
Posted by charlie arehart <ch...@carehart.org>.
Thanks. I'm guessing someone fixed it before you looked, as I see now that it is fixed as well. (And same for the 7 doc.)
Now, if you may be tempted to say that you don’t think anyone had changed it recently, I would just offer here a screenshot of the 8 doc page, from the browser where I tripped over the problem (and which I had not reloaded since seeing your answer here). It clearly shows that it WAS wrong at some point. :-)
And in case the image doesn’t make it through, here’s a dropbox link to it: https://www.dropbox.com/s/k9wivla0vwu91a1/
I can’t imagine any way I’d see that in my browser other than if the link was indeed wrong in the HTML. In fact, I was able to do a view source and there is was:
<li><a href="means-descriptors-howto.html">17) MBeans Descriptors</a></li>
(But I realize that for some users it’s possible that the HTML I just pasted won’t show up.)
As always, just trying to help.
/charlie
-----Original Message-----
> From: Christopher Schultz <ch...@christopherschultz.net>
>
> Charlie,
>
>
> Can you give me a page reference? When looking at:
> http://tomcat.apache.org/tomcat-8.0-doc/index.html
>
> The link has the proper URL.
<snip>
> Specific page? <http://tomcat.apache.org/tomcat-7.0-doc/index.html> http://tomcat.apache.org/tomcat-7.0-doc/index.html looks okay to me.
>
> - -chris
Re: How to offer a link correction for the Tomcat docs?
Posted by Christopher Schultz <ch...@christopherschultz.net>.
-----BEGIN PGP SIGNED MESSAGE-----
Hash: SHA256
Charlie,
On 3/29/18 12:41 PM, charlie arehart wrote:
>> From: Christopher Schultz <ch...@christopherschultz.net> Sent:
>> Thursday, March 29, 2018 10:59 AM
>>
> <snip>
>>
>>> Until that’s resolved, is this or another TC list a good place
>>> to report such a broken link, or other doc suggestion? Thanks.
>>
>> Here is perfect.
>>
>> Which link is broken?
>>
>> - -chris
>
> Thanks, and yep, I would indeed have preferred to add the
> observation as a comment there if I could have. I hope someday
> that system is working again.
>
> So the broken link is the one on the left nav there for "mbeans
> descriptor". While it should go to:
>
> https://tomcat.apache.org/tomcat-8.0-doc/mbeans-descriptors-howto.html
>
> It mistakenly tries to go to the following (missing the b in
> mbeans):
>
> https://tomcat.apache.org/tomcat-8.0-doc/means-descriptors-howto.html
Can
>
you give me a page reference? When looking at:
http://tomcat.apache.org/tomcat-8.0-doc/index.html
The link has the proper URL.
> FWIW, I have checked the other links on the left of that TC 8 User
> Guide, and they otherwise do all work as expected.
>
> Finally, the same error above was in the TC7 docs, if you have
> ability to change those. Again, thanks for stepping in.
Specific page? http://tomcat.apache.org/tomcat-7.0-doc/index.html
looks okay to me.
- -chris
-----BEGIN PGP SIGNATURE-----
Comment: GPGTools - http://gpgtools.org
Comment: Using GnuPG with Thunderbird - http://www.enigmail.net/
iQIzBAEBCAAdFiEEMmKgYcQvxMe7tcJcHPApP6U8pFgFAlq9JPkACgkQHPApP6U8
pFhoQA/8DL9ykS4Ctyuc5xKFWnTVa39+KTRZg0+ZChXRgroSiqs6PEywgNQgFe/N
5t17hEyLb2ND54u+jdhu7UDWtF4CiFcDOoLrMCBScubuTv2SZNaDqv2ifCdQaoqL
fZVW/1MsN14j0VX8DeARz0cS+3T90cd3wvasoNCwDq+QpT8QxX+K/qKH/L2kKCQ4
lhXOZP7diHKjWbgzHrFfRmVNNAIRM6wtfHF6Em+e/VM4lZd3+JiyVL8OAy7L17gP
N4/lOFlo2vliHPKAZtrkzvoWvl7tANU6bIynWBuyOIAfoSw9imhSSO9xdvOlf0hc
HumRjnwusI9w8iPP5VkNjTdGYmpciZursbWdn318miuSkTf3prU58mAP+joCLlNp
fM+ZIPGFi4iqKZKACgy8cvrTu1wFgFU7hJIf40Er7YdymRse0KVT3ckvieMKxSu9
WPOTz+cBx8Wlk7UUsI//qS4jIqS/b+3Y9FTGT5RawtAILzloLJeBqYJhNMayahtm
WthJCsa1ZN9VCah+AYSc2K64Gm3dCm+zr6iYCNSNc7DddosINwfbjt0GygLH8z46
TgTu9ASnuoelQo0YBUKWj8n4pI7dBmmJPXNsbIDSCUUVj5b42PI/DR9hG8ZjYhId
XW9akUX5rteT1QvxzGuNF/aLFygEi3mDaCtzf9gYf4Tf9Jbv1As=
=KjY6
-----END PGP SIGNATURE-----
---------------------------------------------------------------------
To unsubscribe, e-mail: users-unsubscribe@tomcat.apache.org
For additional commands, e-mail: users-help@tomcat.apache.org
RE: How to offer a link correction for the Tomcat docs?
Posted by charlie arehart <ch...@carehart.org>.
>From: Christopher Schultz <ch...@christopherschultz.net>
>Sent: Thursday, March 29, 2018 10:59 AM
>
<snip>
>
> > Until that’s resolved, is this or another TC list a good place to
> > report such a broken link, or other doc suggestion? Thanks.
>
> Here is perfect.
>
> Which link is broken?
>
> - -chris
Thanks, and yep, I would indeed have preferred to add the observation as a comment there if I could have. I hope someday that system is working again.
So the broken link is the one on the left nav there for "mbeans descriptor". While it should go to:
https://tomcat.apache.org/tomcat-8.0-doc/mbeans-descriptors-howto.html
It mistakenly tries to go to the following (missing the b in mbeans):
https://tomcat.apache.org/tomcat-8.0-doc/means-descriptors-howto.html
FWIW, I have checked the other links on the left of that TC 8 User Guide, and they otherwise do all work as expected.
Finally, the same error above was in the TC7 docs, if you have ability to change those. Again, thanks for stepping in.
/charlie
---------------------------------------------------------------------
To unsubscribe, e-mail: users-unsubscribe@tomcat.apache.org
For additional commands, e-mail: users-help@tomcat.apache.org
Re: How to offer a link correction for the Tomcat docs?
Posted by Christopher Schultz <ch...@christopherschultz.net>.
-----BEGIN PGP SIGNED MESSAGE-----
Hash: SHA256
Charlie,
On 3/27/18 6:05 PM, charlie arehart wrote:
> Greetings. I’m a new list member, though a fairly long-time Tomcat
> user.
>
> I found a broken link in the Tomcat User Guide (8 and 7), on its
> left nav bar. How would I best go about reporting such a broken
> link in the Tomcat docs?
>
> To be clear, while there is a comments section at the bottom of the
> doc pages, that points folks to
> https://tomcat.apache.org/tomcat-8.0-doc/comments.html to learn
> more, which in turn points to
> https://comments.apache.org/help.html.
Hmm. When I look at that page (comments.html), the "here" link at the
bottom of the page points to "./comments.html" which just takes me
back to the same page. Oops.
> But that gets a 503 service unavailable error. I find a jira
> discussion indicating this is a long-standing issue, which was
> hoped to be solved by now:
> https://issues.apache.org/jira/browse/INFRA-15947.
:(
> Until that’s resolved, is this or another TC list a good place to
> report such a broken link, or other doc suggestion? Thanks.
Here is perfect.
Which link is broken?
- -chris
-----BEGIN PGP SIGNATURE-----
Comment: GPGTools - http://gpgtools.org
Comment: Using GnuPG with Thunderbird - http://www.enigmail.net/
iQIzBAEBCAAdFiEEMmKgYcQvxMe7tcJcHPApP6U8pFgFAlq9DS8ACgkQHPApP6U8
pFhodA/9H2TtNfzZ7VO1f4qrNu73k469kbOGJy3PmfETp8iyPFvKG7KxsNC2BX3/
le/CFg3ulchlHnR+sZj9WLfQTR1tU702/7LIud1sbJC7XINgphrde+DeYPcK9/pK
22pfPJ966CA8rGGYCFiGRpLYia/Xkuwm0PVe3Z6vgp2nnSxA8wnp7tuOrG96IFrk
SuR6RMo/ab5O6jIRLcckiGGGia8aYna0TaknUYQswAHI787tP8ta2ClzLycDzv0r
K6Ti8HQnI2rormhogrVV+FGxoL7G2Ujik8tME2Fd9ldHbhIiBshsGxwtpbatkX18
6KiKfO5fqcj5SOzTLNeuWz68u21oNcYYTkppxXnlm480NcBSEnVwhAnpT3AWiILw
Ilazi44chaW95hV6ZwalwhJAw4u7A5SKIMa+JeiJ49LVyA90GWOix2THuQi0YsGx
hKqdGAF9pCoQNwwV17krt1jX2vA0iq4Dg52zEWxVfmeYQD5yYap9fnQ9RtPwXZTf
6BonlMgYUvPrw+o6hhLGQx2HOedmHvwlW2sIlH2OHJgEXD3NG9hy8kseKTx0Uk3M
SQbuDAHXaUGgCBLb71SaJ1qWHQ1eYhJQuIF9Ya/nSxXYlA6XbaZStFaNenDoXSt3
a4z5OyvO+sLk9VL+wFMRj/W3QBNtQ/pD9xp1oB9VhixpLfhKkDk=
=Iloc
-----END PGP SIGNATURE-----
---------------------------------------------------------------------
To unsubscribe, e-mail: users-unsubscribe@tomcat.apache.org
For additional commands, e-mail: users-help@tomcat.apache.org
RE: How to offer a link correction for the Tomcat docs?
Posted by charlie arehart <ch...@carehart.org>.
>From: André Warnier (tomcat) <aw...@ice-sa.com>
>
>Hi.
>I think that you are right, there is something not quite right, right now, with the comment section (apparently on all pages).
>As I recall, it used to be that there was an editable section at the bottom of each page, where one could actually write a comment related to the documentation page in question.
>(And that would probably have been the right place to mention the problem).
>
>Now this seems to be replaced everywhere by a fixed message, with links, which don't seem to lead to anywhere one could actually place a comment.
>
>I have no idea if this is intended, but it seems a bit kafka-esque.
>
>Also the top link of the left-hand menu (Docs Home), could be expected to lead to a page covering the docs of all the versions. But instead of that, it seems to loop to the same version on which one already is.
Yep, thanks for the commiseration, André. :-) Hope that comments section will someday be working again. There are actually other "opportunities for improvement" that I have seen and wanted to suggest, and now it's no wonder that such may exist, given the challenge proposing changes (and even with the "comment" mechanism it's not clear if anyone took ownership to make changes).
If there's a way to go about getting permission to actually make actual doc changes and push them for approval by the doc owner, I'd welcome the opp to through that process, to help out.
/charlie
---------------------------------------------------------------------
To unsubscribe, e-mail: users-unsubscribe@tomcat.apache.org
For additional commands, e-mail: users-help@tomcat.apache.org
Re: How to offer a link correction for the Tomcat docs?
Posted by "André Warnier (tomcat)" <aw...@ice-sa.com>.
On 29.03.2018 16:50, charlie arehart wrote:
> Anyone have a suggestion of where better to ask this, if not here?
Hi.
I think that you are right, there is something not quite right, right now, with the
comment section (apparently on all pages).
As I recall, it used to be that there was an editable section at the bottom of each page,
where one could actually write a comment related to the documentation page in question.
(And that would probably have been the right place to mention the problem).
Now this seems to be replaced everywhere by a fixed message, with links, which don't seem
to lead to anywhere one could actually place a comment.
I have no idea if this is intended, but it seems a bit kafka-esque.
Also the top link of the left-hand menu (Docs Home), could be expected to lead to a page
covering the docs of all the versions. But instead of that, it seems to loop to the same
version on which one already is.
>
> /charlie
>
> -----Original Message-----
> From: charlie arehart <ch...@carehart.org>
> Sent: Tuesday, March 27, 2018 05:05 PM
> To: 'Tomcat Users List' <us...@tomcat.apache.org>
> Subject: How to offer a link correction for the Tomcat docs?
>
> Greetings. I’m a new list member, though a fairly long-time Tomcat user.
>
> I found a broken link in the Tomcat User Guide (8 and 7), on its left nav bar. How would I best go about reporting such a broken link in the Tomcat docs?
>
> To be clear, while there is a comments section at the bottom of the doc pages, that points folks to https://tomcat.apache.org/tomcat-8.0-doc/comments.html to learn more, which in turn points to https://comments.apache.org/help.html. But that gets a 503 service unavailable error. I find a jira discussion indicating this is a long-standing issue, which was hoped to be solved by now: https://issues.apache.org/jira/browse/INFRA-15947.
>
>
>
> Until that’s resolved, is this or another TC list a good place to report such a broken link, or other doc suggestion? Thanks.
>
> /charlie
>
>
>
> ---------------------------------------------------------------------
> To unsubscribe, e-mail: users-unsubscribe@tomcat.apache.org
> For additional commands, e-mail: users-help@tomcat.apache.org
>
---------------------------------------------------------------------
To unsubscribe, e-mail: users-unsubscribe@tomcat.apache.org
For additional commands, e-mail: users-help@tomcat.apache.org
RE: How to offer a link correction for the Tomcat docs?
Posted by charlie arehart <ch...@carehart.org>.
Anyone have a suggestion of where better to ask this, if not here?
/charlie
-----Original Message-----
From: charlie arehart <ch...@carehart.org>
Sent: Tuesday, March 27, 2018 05:05 PM
To: 'Tomcat Users List' <us...@tomcat.apache.org>
Subject: How to offer a link correction for the Tomcat docs?
Greetings. I’m a new list member, though a fairly long-time Tomcat user.
I found a broken link in the Tomcat User Guide (8 and 7), on its left nav bar. How would I best go about reporting such a broken link in the Tomcat docs?
To be clear, while there is a comments section at the bottom of the doc pages, that points folks to https://tomcat.apache.org/tomcat-8.0-doc/comments.html to learn more, which in turn points to https://comments.apache.org/help.html. But that gets a 503 service unavailable error. I find a jira discussion indicating this is a long-standing issue, which was hoped to be solved by now: https://issues.apache.org/jira/browse/INFRA-15947.
Until that’s resolved, is this or another TC list a good place to report such a broken link, or other doc suggestion? Thanks.
/charlie
---------------------------------------------------------------------
To unsubscribe, e-mail: users-unsubscribe@tomcat.apache.org
For additional commands, e-mail: users-help@tomcat.apache.org