Issue #3067622 by jhodgdon, batigolix, felribeiro, DeepaliJ, Amber Himes Matz,...

Issue #3067622 by jhodgdon, batigolix, felribeiro, DeepaliJ, Amber Himes Matz, volkswagenchick, eeyorr: Convert forum module hook_help() to topic(s)

core/modules/help_topics/help_topics/forum.concept.html.twig

+---
+label: 'Creating threaded discussion forums'
+top_level: true
+---
+<h2>{% trans %}What is a forum?{% endtrans %}</h2>
+<p>{% trans %}A forum is nested hierarchy of discussions, where users post topics and comment on them.{% endtrans %}</p>
+<h2>{% trans %}What is the forum hierarchy?{% endtrans %}</h2>
+<p>{% trans %}The forum hierarchy consists of:{% endtrans %}
+<ul>
+    <li>{% trans %}<em>Forums</em> (for example, <em>Recipes for cooking vegetables</em>){% endtrans %}</li>
+    <li>{% trans %}Optional <em>containers</em> can be used to group similar forums (for example, <em>Recipes</em>). Forums can be inside containers and vice versa.{% endtrans %}</li>
+    <li>{% trans %}<em>Forum topics</em> submitted by users (for example, <em>How to cook potatoes</em>), which start discussions.{% endtrans %}</li>
+    <li>{% trans %}<em>Comments</em> submitted by users (for example, <em>You wash the potatoes first and then...</em>).{% endtrans %}</li>
+</ul>
+<p>{% trans %}The <em>forums</em> and <em>containers</em> in the hierarchy are implemented as terms in a hierarchical taxonomy vocabulary. The topics are content items posted in forums (not in containers), and replies are comments on each topic item. Deeply nested hierarchies of forums and containers are generally difficult for users to understand and navigate, so it is recommended to keep your hierarchy simple.{% endtrans %}</p>
+<h2>{% trans %}Managing and using forums overview{% endtrans %}</h2>
+<p>{% trans %}The core Forum module supplies a content type called <em>Forum topic</em>, along with associated comment type and taxonomy vocabulary. As with other comment types, you can configure comments on forum topics to be threaded or unthreaded. See the related topics listed below for specific tasks.{% endtrans %}</p>

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

+---
+label: 'Configuring forums'
+related:
+  - forum.concept
+---
+{% set settings = render_var(url('forum.settings')) %}
+{% set overview = render_var(url('forum.overview')) %}
+{% set concept = render_var(url('help.help_topic', {'id': 'forum.concept'})) %}
+{% set index = render_var(url('forum.index')) %}
+<h2>{% trans %}Goal{% endtrans %}</h2>
+<p>{% trans %}Configure settings for forums, and set up forum structure.{% endtrans %}</p>
+<h2>{% trans %}Steps{% endtrans %}</h2>
+<ol>
+  <li>{% trans %}In the <em>Manage</em> administrative menu, navigate to <em>Structure</em> &gt; <em>Forums</em> &gt; <a href="{{ settings }}"><em>Settings</em></a>.{% endtrans %}</li>
+  <li>{% trans %}Choose the desired settings for <em>Hot topic threshold</em>, <em>Topics per page</em>, and <em>Default order</em>. Click <em>Save configuration</em> if you have made any changes.{% endtrans %}</li>
+  <li>{% trans %}In the <em>Manage</em> administrative menu, navigate to <em>Structure</em> &gt; <a href="{{ overview }}"><em>Forums</em></a>.{% endtrans %}</li>
+  <li>{% trans %}Decide on the hierarchy of containers and forums you want for your site; see <a href="{{ concept }}">Creating threaded discussion forums</a> for an overview of forum hierarchy.{% endtrans %}</li>
+  <li>{% trans %}Create the containers that you want in your forum hierarchy, starting at the top level, if any. To create a container, click <em>Add container</em>, enter the container name and optionally other settings, and click <em>Save</em>.{% endtrans %}</li>
+  <li>{% trans %}Create the forums that you want in your forum hierarchy, starting at the top level. To create a forum, click <em>Add forum</em> and enter the forum name. If your hierarchy has this forum inside a container or another forum, select the parent forum/container in the <em>Parent</em> field. Review and/or edit the other settings, and click <em>Save</em>.{% endtrans %}</li>
+  <li>{% trans %}Optionally, delete the provided <em>General discussion</em> forum, if you do not want this forum to be available on your site.{% endtrans %}</li>
+  <li>{% trans %}Review and/or edit the permissions related to forums. The administrative permission for editing the forum settings is in the <em>Forum</em> module section of the permissions page, and administrative permissions for editing the forum hierarchy are in the <em>Taxonomy</em> module section. The user permissions for creating forum topics are in the <em>Node</em> module section, and for commenting on topics are in the <em>Comment</em> module section.{% endtrans %}</li>
+  <li>{% trans %}Add links to the main <a href="{{ index }}"><em>Forums</em></a> page (path: <em>/forum</em>), and optionally to individual forum pages, to navigation menus on your site, so that users can find the forums.{% endtrans %}</li>
+</ol>

core/modules/help_topics/help_topics/forum.locking.html.twig

+---
+label: 'Locking a forum topic'
+related:
+  - forum.concept
+---
+{% set index = render_var(url('forum.index')) %}
+<h2>{% trans %}Goal{% endtrans %}</h2>
+<p>{% trans %}Lock a topic to prevent users from making any more comments.{% endtrans %}</p>
+<h2>{% trans %}Steps{% endtrans %}</h2>
+<ol>
+  <li>{% trans %}Starting from the <a href="{{ index }}">forums page</a>, navigate to the forum that currently contains the topic.{% endtrans %}</li>
+  <li>{% trans %}Locate the topic within the forum, and click on the title to view the topic.{% endtrans %}</li>
+  <li>{% trans %}Click <em>Edit</em>.{% endtrans %}</li>
+  <li>{% trans %}Under <em>Comment settings</em>, check <em>Closed</em>.{% endtrans %}</li>
+  <li>{% trans %}Click <em>Save</em>.{% endtrans %}</li>
+</ol>

core/modules/help_topics/help_topics/forum.moving.html.twig

+---
+label: 'Moving a topic to a new forum'
+related:
+  - forum.concept
+---
+{% set index = render_var(url('forum.index')) %}
+<h2>{% trans %}Goal{% endtrans %}</h2>
+<p>{% trans %}Move a forum topic and all of its comments to a new forum. {% endtrans %}</p>
+<h2>{% trans %}Steps{% endtrans %}</h2>
+<ol>
+  <li>{% trans %}Starting from the <a href="{{ index }}">forums page</a>, navigate to the forum that currently contains the topic.{% endtrans %}</li>
+  <li>{% trans %}Locate the topic within the forum, and click on the title to view the topic.{% endtrans %}</li>
+  <li>{% trans %}Click <em>Edit</em>.{% endtrans %}</li>
+  <li>{% trans %}In the <em>Forums</em> field, select the new forum that you want the topic to move to.{% endtrans %}</li>
+  <li>{% trans %}Check <em>Leave shadow copy</em> to create a link in the original forum pointing to the new location.{% endtrans %}</li>
+  <li>{% trans %}Click <em>Save</em>.{% endtrans %}</li>
+</ol>

core/modules/help_topics/help_topics/forum.starting.html.twig

+---
+label: 'Starting a forum discussion'
+related:
+  - forum.concept
+---
+{% set index = render_var(url('forum.index')) %}
+<h2>{% trans %}Goal{% endtrans %}</h2>
+<p>{% trans %}Post a new topic in a forum to start a discussion.{% endtrans %}</p>
+<h2>{% trans %}Steps{% endtrans %}</h2>
+<ol>
+  <li>{% trans %}Starting from the <a href="{{ index }}">forums page</a>, navigate to the forum where you want to post the topic.{% endtrans %}</li>
+  <li>{% trans %}Click <em>Add new Forum topic</em>.{% endtrans %}</li>
+  <li>{% trans %}Enter the topic's <em>Subject</em> and <em>Body</em>.{% endtrans %}</li>
+  <li>{% trans %}Click <em>Save</em>.{% endtrans %}</li>
+</ol>