Document creation of a comment form for authenticated users

[Scot Hacker]

The documentation does not make clear how to use the Comments framework to create a form for authenticated users (eliding the name, email, and URL fields). Blogs out there are full of half-baked or convoluted solutions for what should be a no-brainer. This doc patch provides what I hope is a "best" approach to this problem.

[Scot Hacker]

Docs for authenticated comment form

[Scot Hacker]

I placed this at the end of the Notes section rather than higher on the page because it's based in part on information provided in Notes.

[Russell Keith-Magee]

The idea is good, but the text needs work. It isn't clear from this example how (or why) the comment will be associated with the authenticated user.

Also, placing this text after "Redirecting after the comment post" (i.e., just before the Notes, as the last section in the "Displaying the comment post form" section) makes more sense to me.

[Scot Hacker]

Here is a second diff that explains why comments are associated with authenticated users. I've also explained the fields in use a bit, moved the block as suggested, and linked various sections to related docs.

[Scot Hacker]

Changes as suggested

[James Bennett]

This isn't critical to 1.2; we can always go back and expand documentation as needed, so attention should focus on actual bugs.

[Aymeric Augustin]

Change UI/UX from NULL to False.

[Aymeric Augustin]

Change Easy pickings from NULL to False.

[Tim Graham]

Updated the patch a bit

[Tim Graham]

Updated the patch a bit

[Tim Graham <timograham@…>]

In fea0ca4334b8c35100c0ca1048f81b9b3573bc26:

Fixed #12871 - Documented creation of a comment form for authenticated users; thanks shacker for patch.