https://bz.apache.org/bugzilla/show_bug.cgi?id=60026

            Bug ID: 60026
           Summary: Please initially hide (red) Notice from Comments
                    section
           Product: Apache httpd-2
           Version: 2.5-HEAD
          Hardware: All
                OS: All
            Status: NEW
          Severity: enhancement
          Priority: P2
         Component: Documentation
          Assignee: docs@httpd.apache.org
          Reporter: chea...@gmail.com

Pages from httpd documentation end with a Comments section where readers are
invited to post comments. This section starts with a notice which reads:

This is not a Q&A section. Comments placed here should be pointed towards
suggestions on improving the documentation or server, and may be removed again
by our moderators if they are either implemented or considered
invalid/off-topic. Questions on how to manage the Apache HTTP Server should be
directed at either our IRC channel, #httpd, on Freenode, or sent to our mailing
lists.

So that commenters do not miss this notice, it is bordered in red. This has the
unfortunate side effect of making that paragraph the most prominent one
(disregarding its positions) of many pages, even though it is the least
relevant, since it must be only a small minority of readers who consider
commenting.

This can be solved be simply initially hiding the notice, until "Post a
comment" is clicked, which should be trivial since there is already JavaScript
to reveal the comment form.

By the way:
I wonder why the notice contains "removed again". Would "removed" not suffice?
The texts "No comments have been made so far." and "The 2.4 branch of the
documentation has comments available for this page. Click here to view them."
do not have to be in different paragraphs. In fact, it would be clearer if they
were not.

-- 
You are receiving this mail because:
You are the assignee for the bug.

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

Reply via email to