first commit

core/modules/comment/help_topics/comment.configuring.html.twig

@@ -0,0 +1,43 @@
+---
+label: 'Configuring comments'
+related:
+  - comment.overview
+  - comment.creating_type
+  - comment.disabling
+  - field_ui.add_field
+---
+{% set comment_permissions_link_text %}
+{% trans %}Administer comments and comment settings{% endtrans %}
+{% endset %}
+{% set comment_permissions_link = render_var(help_route_link(comment_permissions_link_text, 'user.admin_permissions.module', {'modules': 'comment'})) %}
+{% set content_structure_topic = render_var(help_topic_link('core.content_structure')) %}
+{% set comment_type_topic = render_var(help_topic_link('comment.creating_type')) %}
+<h2>{% trans %}Goal{% endtrans %}</h2>
+<p>{% trans %}Configure a content entity type/subtype to allow commenting, using a comment type that you have configured. See {{ content_structure_topic }} for more about content entities and fields, and {{ comment_type_topic }} to configure a comment type.{% endtrans %}</p>
+<h2>{% trans %}Who can configure comments?{% endtrans %}</h2>
+<p>{% trans %}In order to follow these steps, the Field UI module must be installed. You'll need the Comment module's <em>{{ comment_permissions_link }}</em> permission, in order to change comment settings for a comment field. You'll also need to have the appropriate permission for adding fields to the entity type or subtype that the comments are attached to. For example, to add a comment field to content items provided by the Node module, you would need the Node module's <em>Administer content types</em> permission.{% endtrans %}</p>
+<h2>{% trans %}Steps{% endtrans %}</h2>
+<ol>
+  <li>{% trans %}Follow the steps in the related <em>Adding a field to an entity sub-type</em> topic to add a field of type <em>Comments</em> to the desired entity type or sub-type.{% endtrans %}</li>
+  <li>{% trans %}On the first field settings page, choose the <em>Comment type</em> to use for this entity type or sub-type. You'll also notice that the <em>Allowed number of values</em> field cannot be changed for comment fields.{% endtrans %}</li>
+  <li>{% trans %}On the next field settings page, enter the desired settings for the comment field:{% endtrans %}
+    <ul>
+      <li>{% trans %}<em>Threading</em>: whether or not the comments are collected by threads, with people able to reply to particular comments instead of to the content entity itself.{% endtrans %}</li>
+      <li>{% trans %}<em>Comments per page</em>: the maximum number of comments displayed on one page (a pager will be added if you exceed this limit).{% endtrans %}</li>
+      <li>{% trans %}<em>Anonymous commenting</em>: whether or not anonymous commenters are allowed or required to leave contact information with their comments (only applies if anonymous users have permission to post comments).{% endtrans %}</li>
+      <li>{% trans %}<em>Show reply form on the same page as comments</em>: whether the comment reply form is displayed on the same page as the comments. If this is not selected, clicking <em>Reply</em> will open a new page with the reply form.{% endtrans %}</li>
+      <li>{% trans %}<em>Preview comments</em>: whether previewing comments before submission is <em>Required</em>, <em>Optional</em>, or <em>Disabled</em>.{% endtrans %}</li>
+      <li>{% trans %}<em>Default value</em>: each individual entity has its own comment settings, but here you can set defaults for the comment settings for this entity type or subtype. The comment settings values are:{% endtrans %}
+        <ul>
+          <li>{% trans %}<em>Open</em>: comments are allowed.{% endtrans %}</li>
+          <li>{% trans %}<em>Closed</em>: past comments remain visible, but no new comments are allowed.{% endtrans %}</li>
+          <li>{% trans %}<em>Hidden</em>: past comments are hidden, and no new comments are allowed.{% endtrans %}</li>
+        </ul>
+      </li>
+    </ul>
+  </li>
+</ol>
+<h2>{% trans %}Additional resources{% endtrans %}</h2>
+<ul>
+  <li><a href="https://www.drupal.org/docs/8/core/modules/comment/administering-a-content-types-comment-settings">{% trans %}Online documentation for content comment settings{% endtrans %}</a></li>
+</ul>

core/modules/comment/help_topics/comment.creating_type.html.twig

@@ -0,0 +1,32 @@
+---
+label: 'Creating a comment type'
+related:
+  - field_ui.add_field
+  - field_ui.manage_display
+  - field_ui.manage_form
+  - comment.overview
+  - comment.configuring
+---
+{% set comment_types_link_text %}
+  {% trans %}Comment types{% endtrans %}
+{% endset %}
+{% set comment_types_link = render_var(help_route_link(comment_types_link_text, 'entity.comment_type.collection')) %}
+{% set comment_permissions_link_text %}
+  {% trans %}Administer comment types and settings{% endtrans %}
+{% endset %}
+{% set comment_permissions_link = render_var(help_route_link(comment_permissions_link_text, 'user.admin_permissions.module', {'modules': 'comment'})) %}
+{% set comment_overview_topic = render_var(help_topic_link('comment.overview')) %}
+{% set content_structure_topic = render_var(help_topic_link('core.content_structure')) %}
+<h2>{% trans %}Goal{% endtrans %}</h2>
+<p>{% trans %}Create a new comment type. See {{ comment_overview_topic }} for information about comments and comment types.{% endtrans %}</p>
+<h2>{% trans %}Who can create a comment type?{% endtrans %}</h2>
+<p>{% trans %}Users with the <em>{{ comment_permissions_link }}</em> permission (typically administrators) can create comment types.{% endtrans %}</p>
+<h2>{% trans %}Steps{% endtrans %}</h2>
+<ol>
+  <li>{% trans %}In the <em>Manage</em> administrative menu, navigate to <em>Structure</em> &gt; <em>{{ comment_types_link }}</em>.{% endtrans %}</li>
+  <li>{% trans %}Click <em>Add comment type</em>.{% endtrans %}</li>
+  <li>{% trans %}In the <em>Label</em> field, enter a name for the comment type, which is how it will be listed in the administrative interface.{% endtrans %}</li>
+  <li>{% trans %}In the <em>Target entity type</em> field, select the entity type to be commented on. See {{ content_structure_topic }} for more about content entities and fields.{% endtrans %}</li>
+  <li>{% trans %}Click <em>Save</em>. The comment type will be created.{% endtrans %}</li>
+  <li>{% trans %}Optionally, if you have the core Field UI module installed you can follow the steps in the related topics to add fields to the new comment type, set up the editing form, and configure the display.{% endtrans %}</li>
+</ol>

core/modules/comment/help_topics/comment.disabling.html.twig

@@ -0,0 +1,28 @@
+---
+label: 'Disabling comments'
+related:
+  - comment.overview
+  - comment.configuring
+---
+{% set comment_permissions_text %}
+{% trans %}Administer comments and comment settings{% endtrans %}
+{% endset %}
+{% set comment_permissions_link = render_var(help_route_link(comment_permissions_text, 'user.admin_permissions.module', {'modules': 'comment'})) %}
+{% set comment_config_topic = render_var(help_topic_link('comment.configuring')) %}
+{% set content_structure_topic = render_var(help_topic_link('core.content_structure')) %}
+<h2>{% trans %}Goal{% endtrans %}</h2>
+<p>{% trans %}Turn off commenting for a particular entity (see {{ content_structure_topic }} for more about content entities and fields). Note that if you want to turn off commenting for all entities of an entity type or subtype, you will need to edit the field settings for the comment field; see {{ comment_config_topic }} for more about configuring the comment field.{% endtrans %}</p>
+<h2>{% trans %}Who can disable comments?{% endtrans %}</h2>
+<p>{% trans %}You will need the <em>{{ comment_permissions_link }}</em> permission in order to disable commenting. You will also need permission to edit the entity that the comments are on.{% endtrans %}</p>
+<h2>{% trans %}Steps{% endtrans %}</h2>
+<ol>
+  <li>{% trans %}Find the entity you want to disable comments for, and edit it. For example, to turn off comments on a content item, you could find it by navigating in the <em>Manage</em> administrative menu to <em>Content</em>, filtering to find the content item, and clicking <em>Edit</em>.{% endtrans %}</li>
+  <li>{% trans %}Under <em>Comment settings</em>, select the desired comment setting:{% endtrans %}
+    <ul>
+      <li>{% trans %}<em>Open</em>: comments are allowed.{% endtrans %}</li>
+      <li>{% trans %}<em>Closed</em>: past comments remain visible, but no new comments are allowed.{% endtrans %}</li>
+      <li>{% trans %}<em>Hidden</em>: past comments are hidden, and no new comments are allowed.{% endtrans %}</li>
+    </ul>
+  </li>
+  <li>{% trans %}Save the entity.{% endtrans %}</li>
+</ol>

core/modules/comment/help_topics/comment.moderating.html.twig

@@ -0,0 +1,34 @@
+---
+label: 'Moderating comments'
+related:
+  - comment.overview
+  - comment.configuring
+  - comment.disabling
+---
+{% set comment_unpublished_link_text %}
+  {% trans %}Unapproved comments{% endtrans %}
+{% endset %}
+{% set comment_unpublished_link = render_var(help_route_link(comment_unpublished_link_text, 'comment.admin_approval')) %}
+{% set comment_published_link_text %}
+  {% trans %}Comments{% endtrans %}
+{% endset %}
+{% set comment_published_link = render_var(help_route_link(comment_published_link_text, 'comment.admin')) %}
+{% set comment_permissions_link_text %}
+  {% trans %}Administer comments and comment settings{% endtrans %}
+{% endset %}
+{% set comment_permissions_link = render_var(help_route_link(comment_permissions_link_text, 'user.admin_permissions.module', {'modules': 'comment'})) %}
+<h2>{% trans %}Goal{% endtrans %}</h2>
+<p>{% trans %}Decide which comments are shown on the website.{% endtrans %}</p>
+<h2>{% trans %}Who can moderate comments?{% endtrans %}</h2>
+<p>{% trans %}Users with the <em>{{ comment_permissions_link }}</em> permission (typically administrators) can moderate comments. You will also need the <em>Access the Content Overview page</em> permission from the Node module (if it is installed) to navigate to the comment management page.{% endtrans %}</p>
+<h2>{% trans %}Steps{% endtrans %}</h2>
+<ol>
+  <li>{% trans %}In the <em>Manage</em> administrative menu, navigate to <em>Content</em> &gt; <em>{{ comment_published_link }}</em>. A list of all comments is shown.{% endtrans %}</li>
+  <li>{% trans %}To unpublish comments, select one or more comments by checking the boxes on the left side (right side in right-to-left languages). Then select <em>Unpublish comment</em> from the <em>Action</em> select list and click <em>Apply to selected items</em>. If you select the <em>Delete comment</em> action, you can instead delete the unwanted  comments.{% endtrans %}</li>
+  <li>{% trans %}To change the content of a comment click <em>Edit</em> from the dropdown button for a particular comment.{% endtrans %}</li>
+  <li>{% trans %}To publish comments that are not yet visible on the website, navigate to the <em>{{ comment_unpublished_link }}</em> tab. Select one or more comments by checking the boxes on the left side (right side in right-to-left languages). Then select <em>Publish comment</em> from the <em>Action</em> select list and click <em>Apply to selected items</em>.{% endtrans %}</li>
+</ol>
+<h2>{% trans %}Additional resources{% endtrans %}</h2>
+<ul>
+  <li><a href="https://www.drupal.org/docs/8/core/modules/comment/administering-and-approving-comments">{% trans %}Online documentation for moderating comments{% endtrans %}</a></li>
+</ul>

core/modules/comment/help_topics/comment.overview.html.twig

@@ -0,0 +1,29 @@
+---
+label: 'Managing comments'
+top_level: true
+related:
+  - comment.moderating
+  - comment.configuring
+  - comment.creating_type
+  - comment.disabling
+  - field_ui.add_field
+  - field_ui.manage_display
+  - field_ui.manage_form
+---
+{% set content_structure_topic = render_var(help_topic_link('core.content_structure')) %}
+{% set users_overview_topic = render_var(help_topic_link('user.overview')) %}
+<h2>{% trans %}What is a comment?{% endtrans %}</h2>
+<p>{% trans %}A comment is a piece of content, typically posted by a website visitor, which provides discussion or commentary on other content like blog posts and news articles. Comments are a type of content entity, and can have fields that store text, HTML markup, and other data. Comments are attached to other content entities via Comment fields. See {{ content_structure_topic }} for more about content entities and fields.{% endtrans %}</p>
+<h2>{% trans %}What is a comment type?{% endtrans %}</h2>
+<p>{% trans %}Comments are divided into <em>comment types</em>, which are the entity sub-types for the comment entity type. Each comment type has its own fields and its own form and display settings; each type can be used to comment on a single entity type. You can set up different comment types for different commenting purposes on your web site; for example, you might set up a comment type for recipes that has fields "How did it taste?" and "Did the instructions work?", and another comment type for blog entries that has only a generic comment body field.{% endtrans %}</p>
+<h2>{% trans %}What is moderation?{% endtrans %}</h2>
+<p>{% trans %}<em>Moderation</em> is a workflow where comments posted by some users on your site are verified before being published, to prevent spam and other bad behavior. The core software provides basic moderation functionality: you can configure permissions so that new comments posted by some user roles start as unpublished until a user with a different role reviews and publishes them. Contributed modules provide additional moderation and spam-reduction functionality, such as requiring untrusted users pass a CAPTCHA test before submitting comments and letting community members flag comments as possible spam. See {{ users_overview_topic }} for more about users, permissions, and roles.{% endtrans %}</p>
+<h2>{% trans %}Overview of managing comments{% endtrans %}</h2>
+<p>{% trans %}The core Comment module provides the following functionality:{% endtrans %}</p>
+<ul>
+  <li>{% trans %}Posting comments{% endtrans %}</li>
+  <li>{% trans %}Creating comment types; the core Field UI module allows you to attach fields to comment types and attach comment reference fields to other entities so that people can comment on them.{% endtrans %}</li>
+  <li>{% trans %}Configuring commenting{% endtrans %}</li>
+  <li>{% trans %}Moderating comments as discussed above{% endtrans %}</li>
+</ul>
+<p>{% trans %}See the related topics listed below for specific tasks.{% endtrans %}</p>