From e493ebce0675fc005f2a2a307ac6423ca888de46 Mon Sep 17 00:00:00 2001 From: "Kim (Sumo Logic)" <56411016+kimsauce@users.noreply.github.com> Date: Thu, 24 Apr 2025 07:16:15 -0400 Subject: [PATCH 1/3] Update remove-doc.md --- docs/contributing/remove-doc.md | 15 ++++++++------- 1 file changed, 8 insertions(+), 7 deletions(-) diff --git a/docs/contributing/remove-doc.md b/docs/contributing/remove-doc.md index bbcf840399..e7e8aeae39 100644 --- a/docs/contributing/remove-doc.md +++ b/docs/contributing/remove-doc.md @@ -1,12 +1,12 @@ --- id: remove-doc -title: Remove a Doc +title: Move or remove a Doc description: Learn how to properly remove a Sumo Logic doc. --- import useBaseUrl from '@docusaurus/useBaseUrl'; -When you delete a doc, its URL is also deleted. Visiting the old URL will return a `404 - Page Not Found` error, which negatively impacts customer experience and can damage our SEO. +When you move a doc or remove it altogether, that deletes its URL. Visiting the old URL will return a `404 - Page Not Found` error, which negatively impacts customer experience and can damage our SEO. To prevent this, create a 301 redirect. Follow these steps to ensure a smooth transition and maintain the health of our docs site. @@ -31,11 +31,12 @@ As an example, let's say there are two docs called **Nginx App** and **Nginx (Le Ensure any internal links pointing to the deleted doc are updated to the new URL. 1. In your GitHub authoring tool, run a search for the URL you're removing. For example, if the legacy URL appears in other documents, replace all instances with the new URL.
Screenshot of a 'Find All' search for the URL to be removed -1. Check with a Sumo Logic subject matter expert to confirm that you can replace all with the new URL. - -:::warning -Never do a "Find All > Replace All", as this can break unrelated items like image paths. Replace each URL on a one-by-one basis. -::: + :::warning + Never do a Find All > Replace All, as this can break unrelated items like image paths. Replace each URL on a one-by-one basis. + ::: +1. If applicable: + * Remove from its parent index.md hub page. + * Remove from [Product List](/docs/integrations/product-list/). ## Step 3: Delete the doc file From e79f6a13eb19f0235c897036bb47fb18991f54c2 Mon Sep 17 00:00:00 2001 From: "Kim (Sumo Logic)" <56411016+kimsauce@users.noreply.github.com> Date: Thu, 24 Apr 2025 07:17:04 -0400 Subject: [PATCH 2/3] Update docs/contributing/remove-doc.md --- docs/contributing/remove-doc.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/docs/contributing/remove-doc.md b/docs/contributing/remove-doc.md index e7e8aeae39..1d90e92db8 100644 --- a/docs/contributing/remove-doc.md +++ b/docs/contributing/remove-doc.md @@ -1,6 +1,6 @@ --- id: remove-doc -title: Move or remove a Doc +title: Move or Remove a Doc description: Learn how to properly remove a Sumo Logic doc. --- From 5b66a1c13759335753ee154dad88b55dcf06b55b Mon Sep 17 00:00:00 2001 From: "Kim (Sumo Logic)" <56411016+kimsauce@users.noreply.github.com> Date: Thu, 24 Apr 2025 07:17:25 -0400 Subject: [PATCH 3/3] Update docs/contributing/remove-doc.md --- docs/contributing/remove-doc.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/docs/contributing/remove-doc.md b/docs/contributing/remove-doc.md index 1d90e92db8..334f8dae79 100644 --- a/docs/contributing/remove-doc.md +++ b/docs/contributing/remove-doc.md @@ -1,7 +1,7 @@ --- id: remove-doc title: Move or Remove a Doc -description: Learn how to properly remove a Sumo Logic doc. +description: Learn how to properly move or remove a Sumo Logic doc. --- import useBaseUrl from '@docusaurus/useBaseUrl';