From ad6b5825bf35073912039dbff24b1b502b6a228d Mon Sep 17 00:00:00 2001
From: Alan Guo Xiang Tan <gxtan1990@gmail.com>
Date: Mon, 1 Aug 2022 15:19:52 +0800
Subject: [PATCH] DEV: `addTopicsSectionLink` -> `addCommunitySectionLink`
 plugin api (#17740)

---
 .../javascripts/discourse/app/lib/plugin-api.js      | 12 ++++++------
 .../acceptance/sidebar-community-section-test.js     |  4 ++--
 2 files changed, 8 insertions(+), 8 deletions(-)

diff --git a/app/assets/javascripts/discourse/app/lib/plugin-api.js b/app/assets/javascripts/discourse/app/lib/plugin-api.js
index e0897897020..d39b777acec 100644
--- a/app/assets/javascripts/discourse/app/lib/plugin-api.js
+++ b/app/assets/javascripts/discourse/app/lib/plugin-api.js
@@ -1627,12 +1627,12 @@ class PluginApi {
 
   /**
    * EXPERIMENTAL. Do not use.
-   * Support for adding a link under Sidebar topics section by returning a class which extends from the BaseSectionLink
+   * Support for adding a navigation link to Sidebar Community section by returning a class which extends from the BaseSectionLink
    * class interface. See `lib/sidebar/community-section/base-section-link.js` for documentation on the BaseSectionLink class
    * interface.
    *
    * ```
-   * api.addTopicsSectionLink((baseSectionLink) => {
+   * api.addCommunitySectionLink((baseSectionLink) => {
    *   return class CustomSectionLink extends baseSectionLink {
    *     get name() {
    *       return "bookmarked";
@@ -1660,7 +1660,7 @@ class PluginApi {
    * or
    *
    * ```
-   * api.addTopicsSectionLink({
+   * api.addCommunitySectionLink({
    *   name: "unread",
    *   route: "discovery.unread",
    *   title: I18n.t("some.unread.title"),
@@ -1668,17 +1668,17 @@ class PluginApi {
    * })
    * ```
    *
-   * @callback addTopicsSectionLinkCallback
+   * @callback addCommunitySectionLinkCallback
    * @param {BaseSectionLink} baseSectionLink - Factory class to inherit from.
    * @returns {BaseSectionLink} - A class that extends BaseSectionLink.
    *
-   * @param {(addTopicsSectionLinkCallback|Object)} arg - A callback function or an Object.
+   * @param {(addCommunitySectionLinkCallback|Object)} arg - A callback function or an Object.
    * @param {string} arg.name - The name of the link. Needs to be dasherized and lowercase.
    * @param {string} arg.route - The Ember route of the link.
    * @param {string} arg.title - The title attribute for the link.
    * @param {string} arg.text - The text to display for the link.
    */
-  addTopicsSectionLink(arg) {
+  addCommunitySectionLink(arg) {
     addSectionLink(arg);
   }
 
diff --git a/app/assets/javascripts/discourse/tests/acceptance/sidebar-community-section-test.js b/app/assets/javascripts/discourse/tests/acceptance/sidebar-community-section-test.js
index 390f73c97bf..283c7a92010 100644
--- a/app/assets/javascripts/discourse/tests/acceptance/sidebar-community-section-test.js
+++ b/app/assets/javascripts/discourse/tests/acceptance/sidebar-community-section-test.js
@@ -758,7 +758,7 @@ acceptance("Sidebar - Community Section", function (needs) {
 
   test("adding section link via plugin API with Object", async function (assert) {
     withPluginApi("1.2.0", (api) => {
-      api.addTopicsSectionLink({
+      api.addCommunitySectionLink({
         name: "unread",
         route: "discovery.unread",
         text: "unread topics",
@@ -791,7 +791,7 @@ acceptance("Sidebar - Community Section", function (needs) {
 
   test("adding section link via plugin API with callback function", async function (assert) {
     withPluginApi("1.2.0", (api) => {
-      api.addTopicsSectionLink((baseSectionLink) => {
+      api.addCommunitySectionLink((baseSectionLink) => {
         return class CustomSectionLink extends baseSectionLink {
           get name() {
             return "user-summary";