Mailing List Archive

Removing comments section
It is my intent to drop the comments section from the bottom of each
page of the httpd documentation, since it has been broken for YEARS, and
is simply confusing when people see it there, but it doesn't work.

If you object to this, or wish to go fix the comments section, please
speak up.

Since this is a significant change, I'm going let this sit for a few
days, so that there can been some comment/feedback. Of course, it can
always be reverted if someone does want to fix the comments tool in the
future, but I think this warrants (at least the opportunity for) discussion.

--Rich

---------------------------------------------------------------------
To unsubscribe, e-mail: docs-unsubscribe@httpd.apache.org
For additional commands, e-mail: docs-help@httpd.apache.org
Re: Removing comments section [ In reply to ]
On Mon, Jan 24, 2022 at 12:54 PM Rich Bowen <rbowen@rcbowen.com> wrote:
>
> It is my intent to drop the comments section from the bottom of each
> page of the httpd documentation, since it has been broken for YEARS, and
> is simply confusing when people see it there, but it doesn't work.

+1

---------------------------------------------------------------------
To unsubscribe, e-mail: docs-unsubscribe@httpd.apache.org
For additional commands, e-mail: docs-help@httpd.apache.org
Re: Removing comments section [ In reply to ]
Le 24/01/2022 à 18:54, Rich Bowen a écrit :
> It is my intent to drop the comments section from the bottom of each
> page of the httpd documentation, since it has been broken for YEARS, and
> is simply confusing when people see it there, but it doesn't work.
>
> If you object to this, or wish to go fix the comments section, please
> speak up.
>
> Since this is a significant change, I'm going let this sit for a few
> days, so that there can been some comment/feedback. Of course, it can
> always be reverted if someone does want to fix the comments tool in the
> future, but I think this warrants (at least the opportunity for)
> discussion.
>
> --Rich

-0.9

I would love the comment system to be resurrected.

There are a few Jira tickets about it.

https://issues.apache.org/jira/browse/SOLR-12018
is the one that is still opened.

I've never had any feedback of why if was down.
Neither via Jira, nor by mail.

If it is a question of time to maintain the lua scripts, I volunteer.
If it is a question of moderation, I volunteer.
If it is a question of "could be improved" on the admin side of the
scripts, I volunteer.
If it is a question of load on a server, a few things can be optimized
on the existing code base.

I guess that Infra is needed to have it live again. So if the shutdown
is related to something else (security for example), well, if infra does
want, nothing much can be done.


I think that the comment system was (is) great, easy to use and useful
to get feedback on the doc (and sometimes on some wanted functionalities)

Just my 2c, hoping some others share my point of view and that infra can
get it back.

CJ

---------------------------------------------------------------------
To unsubscribe, e-mail: docs-unsubscribe@httpd.apache.org
For additional commands, e-mail: docs-help@httpd.apache.org
Re: Removing comments section [ In reply to ]
Hello,

I agree that the comment system was (is) great, easy to use and useful
to get feedback on the doc

But if it comes up again, it should be well specified on each page that
it is a comment system about the doc only, and that if people want to
get more details or solve problems about httpd config, they should post
their questions in users mailing list.

Lucien

Le 24/01/2022 à 21:16, Christophe JAILLET a écrit :
> Le 24/01/2022 à 18:54, Rich Bowen a écrit :
>> It is my intent to drop the comments section from the bottom of each
>> page of the httpd documentation, since it has been broken for YEARS,
>> and is simply confusing when people see it there, but it doesn't work.
>>
>> If you object to this, or wish to go fix the comments section, please
>> speak up.
>>
>> Since this is a significant change, I'm going let this sit for a few
>> days, so that there can been some comment/feedback. Of course, it can
>> always be reverted if someone does want to fix the comments tool in
>> the future, but I think this warrants (at least the opportunity for)
>> discussion.
>>
>> --Rich
>
> -0.9
>
> I would love the comment system to be resurrected.
>
> There are a few Jira tickets about it.
>
> https://issues.apache.org/jira/browse/SOLR-12018
> is the one that is still opened.
>
> I've never had any feedback of why if was down.
> Neither via Jira, nor by mail.
>
> If it is a question of time to maintain the lua scripts, I volunteer.
> If it is a question of moderation, I volunteer.
> If it is a question of "could be improved" on the admin side of the
> scripts, I volunteer.
> If it is a question of load on a server, a few things can be optimized
> on the existing code base.
>
> I guess that Infra is needed to have it live again. So if the shutdown
> is related to something else (security for example), well, if infra
> does want, nothing much can be done.
>
>
> I think that the comment system was (is) great, easy to use and useful
> to get feedback on the doc (and sometimes on some wanted functionalities)
>
> Just my 2c, hoping some others share my point of view and that infra
> can get it back.
>
> CJ
>
> ---------------------------------------------------------------------
> To unsubscribe, e-mail: docs-unsubscribe@httpd.apache.org
> For additional commands, e-mail: docs-help@httpd.apache.org
>

---------------------------------------------------------------------
To unsubscribe, e-mail: docs-unsubscribe@httpd.apache.org
For additional commands, e-mail: docs-help@httpd.apache.org
Re: Removing comments section [ In reply to ]
On 1/24/22 15:16, Christophe JAILLET wrote:
> Le 24/01/2022 à 18:54, Rich Bowen a écrit :
>> It is my intent to drop the comments section from the bottom of each
>> page of the httpd documentation, since it has been broken for YEARS,
>> and is simply confusing when people see it there, but it doesn't work.
>>
>> If you object to this, or wish to go fix the comments section, please
>> speak up.
>>
>> Since this is a significant change, I'm going let this sit for a few
>> days, so that there can been some comment/feedback. Of course, it can
>> always be reverted if someone does want to fix the comments tool in
>> the future, but I think this warrants (at least the opportunity for)
>> discussion.
>>
>> --Rich
>
> -0.9
>
> I would love the comment system to be resurrected.
>
> There are a few Jira tickets about it.
>
> https://issues.apache.org/jira/browse/SOLR-12018
> is the one that is still opened.
>
> I've never had any feedback of why if was down.
> Neither via Jira, nor by mail.
>
> If it is a question of time to maintain the lua scripts, I volunteer.
> If it is a question of moderation, I volunteer.
> If it is a question of "could be improved" on the admin side of the
> scripts, I volunteer.
> If it is a question of load on a server, a few things can be optimized
> on the existing code base.
>
> I guess that Infra is needed to have it live again. So if the shutdown
> is related to something else (security for example), well, if infra does
> want, nothing much can be done.
>
>
> I think that the comment system was (is) great, easy to use and useful
> to get feedback on the doc (and sometimes on some wanted functionalities)
>
> Just my 2c, hoping some others share my point of view and that infra can
> get it back.

Awesome. Glad to hear that you volunteer to get it going again.

I have no idea what the problem is - just that it doesn't work, and
hasn't for a few years, and nobody has stepped up to fix it.

Thanks.

--Rich

---------------------------------------------------------------------
To unsubscribe, e-mail: docs-unsubscribe@httpd.apache.org
For additional commands, e-mail: docs-help@httpd.apache.org
Re: Removing comments section [ In reply to ]
Christophe,

About a year ago you volunteered to maintain/fix the broken comment system. However, this issue is still outstanding, and the docs still have an inactive "Comments" section at the bottom of each page.

Is it still your intent to fix this?

https://bz.apache.org/bugzilla/show_bug.cgi?id=62227 is now almost 5 years old, and the broken "Comments" sections are, to be honest, a bit of an embarrassment.

I would propose, yet again, that we should drop it, unless someone is actually planning to work on fixing it.

What do y'all think?

--Rich

On 2022/01/24 20:16:30 Christophe JAILLET wrote:
> Le 24/01/2022 à 18:54, Rich Bowen a écrit :
> > It is my intent to drop the comments section from the bottom of each
> > page of the httpd documentation, since it has been broken for YEARS, and
> > is simply confusing when people see it there, but it doesn't work.
> >
> > If you object to this, or wish to go fix the comments section, please
> > speak up.
> >
> > Since this is a significant change, I'm going let this sit for a few
> > days, so that there can been some comment/feedback. Of course, it can
> > always be reverted if someone does want to fix the comments tool in the
> > future, but I think this warrants (at least the opportunity for)
> > discussion.
> >
> > --Rich
>
> -0.9
>
> I would love the comment system to be resurrected.
>
> There are a few Jira tickets about it.
>
> https://issues.apache.org/jira/browse/SOLR-12018
> is the one that is still opened.
>
> I've never had any feedback of why if was down.
> Neither via Jira, nor by mail.
>
> If it is a question of time to maintain the lua scripts, I volunteer.
> If it is a question of moderation, I volunteer.
> If it is a question of "could be improved" on the admin side of the
> scripts, I volunteer.
> If it is a question of load on a server, a few things can be optimized
> on the existing code base.
>
> I guess that Infra is needed to have it live again. So if the shutdown
> is related to something else (security for example), well, if infra does
> want, nothing much can be done.
>
>
> I think that the comment system was (is) great, easy to use and useful
> to get feedback on the doc (and sometimes on some wanted functionalities)
>
> Just my 2c, hoping some others share my point of view and that infra can
> get it back.
>
> CJ
>
> ---------------------------------------------------------------------
> To unsubscribe, e-mail: docs-unsubscribe@httpd.apache.org
> For additional commands, e-mail: docs-help@httpd.apache.org
>
>

---------------------------------------------------------------------
To unsubscribe, e-mail: docs-unsubscribe@httpd.apache.org
For additional commands, e-mail: docs-help@httpd.apache.org
Re: Removing comments section [ In reply to ]
Le 11/01/2023 à 16:50, Rich Bowen a écrit :
> Christophe,
>
> About a year ago you volunteered to maintain/fix the broken comment system. However, this issue is still outstanding, and the docs still have an inactive "Comments" section at the bottom of each page.
>
> Is it still your intent to fix this?
>
> https://bz.apache.org/bugzilla/show_bug.cgi?id=62227 is now almost 5 years old, and the broken "Comments" sections are, to be honest, a bit of an embarrassment.
>
> I would propose, yet again, that we should drop it, unless someone is actually planning to work on fixing it.
>
> What do y'all think?

Hi,

If the needed infrastructure can be resurrected, I still confirm that I
would agree to maintain it.

The code that was used is in:

https://svn.apache.org/repos/infra/infrastructure/trunk/projects/comments

But a DB is needed somewhere, and mod_lua must be running somewhere.
This used to be on https://comments.apache.org, but it is no more
existing, AFAIK.


I don't know if what is used for https://httpd.apache.org/docs can be
used for that or if some configuration changes are needed.


I've asked infra in different tickets and mails to Daniel if this could
be resurrected, but never really got any answer.


If their are some security reasons for the removal of comments.a.o, I
would understand, but I've never been told so.
If it is a load issue, scripts and some SQL queries can be optimized to
reduce the load.
If it is a "spam issue" in the comments themselves, I don't remind that
there was much of them.

AFAIK, there is nothing to *fix* (i.e. bug or security issue), at least,
no known issue I'm aware of.


My proposal is to:
- maintain the lua scripts
- update docs based on relevant comments
- moderate comments when needed


If the needed infra can't be set up, I agree with you that it should be
dropped from the online doc, either completely dropped or at least via a
option when the doc is built. (I think that Eric proposed something
about it a long time ago)

But if it can be alive again, I'm still around and still volunteer.

CJ

>
> --Rich
>
> On 2022/01/24 20:16:30 Christophe JAILLET wrote:
>> Le 24/01/2022 à 18:54, Rich Bowen a écrit :
>>> It is my intent to drop the comments section from the bottom of each
>>> page of the httpd documentation, since it has been broken for YEARS, and
>>> is simply confusing when people see it there, but it doesn't work.
>>>
>>> If you object to this, or wish to go fix the comments section, please
>>> speak up.
>>>
>>> Since this is a significant change, I'm going let this sit for a few
>>> days, so that there can been some comment/feedback. Of course, it can
>>> always be reverted if someone does want to fix the comments tool in the
>>> future, but I think this warrants (at least the opportunity for)
>>> discussion.
>>>
>>> --Rich
>>
>> -0.9
>>
>> I would love the comment system to be resurrected.
>>
>> There are a few Jira tickets about it.
>>
>> https://issues.apache.org/jira/browse/SOLR-12018
>> is the one that is still opened.
>>
>> I've never had any feedback of why if was down.
>> Neither via Jira, nor by mail.
>>
>> If it is a question of time to maintain the lua scripts, I volunteer.
>> If it is a question of moderation, I volunteer.
>> If it is a question of "could be improved" on the admin side of the
>> scripts, I volunteer.
>> If it is a question of load on a server, a few things can be optimized
>> on the existing code base.
>>
>> I guess that Infra is needed to have it live again. So if the shutdown
>> is related to something else (security for example), well, if infra does
>> want, nothing much can be done.
>>
>>
>> I think that the comment system was (is) great, easy to use and useful
>> to get feedback on the doc (and sometimes on some wanted functionalities)
>>
>> Just my 2c, hoping some others share my point of view and that infra can
>> get it back.
>>
>> CJ
>>
>> ---------------------------------------------------------------------
>> To unsubscribe, e-mail: docs-unsubscribe@httpd.apache.org
>> For additional commands, e-mail: docs-help@httpd.apache.org
>>
>>


---------------------------------------------------------------------
To unsubscribe, e-mail: docs-unsubscribe@httpd.apache.org
For additional commands, e-mail: docs-help@httpd.apache.org
Re: Removing comments section [ In reply to ]
On Sun, Jan 22, 2023, 10:27 Christophe JAILLET <
christophe.jaillet@wanadoo.fr> wrote:

>
>
> If their are some security reasons for the removal of comments.a.o, I
> would understand, but I've never been told so.
> If it is a load issue, scripts and some SQL queries can be optimized to
> reduce the load.
> If it is a "spam issue" in the comments themselves, I don't remind that
> there was much of them.
>
> AFAIK, there is nothing to *fix* (i.e. bug or security issue), at least,
> no known issue I'm aware of.
>


The issue is that for 5+ years we have said that there's a comment section
when there isn't. This gives a distinct air that the docs are abandoned
and unmaintained.

That's the whole story.

We need to either have a comments section or quit saying we do.