Merge pull request #559 from newrelic/Updates-to-processes-procedures-docs-DOC-6424

DOC-6424 - style guide edits

Author: zuluecho9

src/content/docs/new-relic-only/tech-writer-style-guide/processes-procedures/clear-cache.mdx

@@ -15,22 +15,9 @@ redirects:
   When you delete a document, its content and all redirects to it are completely and irreversibly deleted. If you believe the document may be of use in the future, OR if you do not want to re-create its redirects, consider another method to [hide the document](/docs/new-relic-only/advanced-style-guide/processes-procedures/hiding-content) from public view.
 </Callout>
 
-If you are certain you want to delete a Drupal document, follow the steps below or watch our 16 minute [video](https://drive.google.com/file/d/1eeN9HZT5MCPE_-qx1Ef4AFycsp0O_lLV/view?usp=sharing):
+If you are certain you want to delete a document, do this:
 
-1. From your Okta login, locate the document you want to delete on the Docs site, and select **Edit**.
-2. Copy all the source HTML and save it to a Jira for safekeeping (in case we need it again).
-3. Check whether the doc you want to delete and the doc you want to redirect it to [have both been translated](/docs/new-relic-only/basic-style-guide/writing-guidelines/manage-translated-docs#translation-status). If yes, notify the [Tech Docs team's liaison for translation projects](https://newrelic.jiveon.com/docs/DOC-6596).
-4. Copy the following information from the document you plan to delete into a temporary text file:
-   * In **URL path settings:** Copy the URL alias for the document you are about to delete.
-   * In the browser address bar: Copy `node/` and the number that follows (for example, `node/10796`).
-   * In **URL redirects:** Copy each path under **From** (for example, `docs/enable-infinite-tracing)`. (Or, for each existing redirect click **Edit** and update the destination node.)
-5. At the bottom of the page, click **Delete**, then confirm the deletion of the file.
-6. Go to the document you want to redirect users to, and open it in the Drupal editor.
-7. Click **URL redirects**, and then click **Add URL redirect to this content**.
-8. Copy the first value from your temporary redirects text file into **From**, and then select **Save**.
-9. Repeat this redirect routine, adding the remaining nodes and/or paths to to create individual redirects.
-
-   <Callout variant="tip">
-     If you need additional help with redirect options, see [Create a redirect](/docs/new-relic-only/advanced-style-guide/processes-procedures/rename-redirect-document#redirects).
-   </Callout>
-10. Save the document.
+1. Locate the doc you want to delete. 
+2. Save the doc's content in a file and attach it to an associated Jira (in case we need the doc again).
+3. PENDING: INFO ON REDIRECTS
+4. Delete the doc and commit change. 

src/content/docs/new-relic-only/tech-writer-style-guide/processes-procedures/delete-document.mdx

@@ -21,40 +21,12 @@ Embed videos as an additional aid for readers when appropriate; for example, tip
 * New Relic University has its own site: [learn.newrelic.com](https://learn.newrelic.com/).
 * Marketing also stores a library of videos at [newrelic.com/resources/videos](https://newrelic.com/resources/videos) and [newrelic.com/resources/webinars](https://newrelic.com/resources/webinars).
 
-Videos are hosted externally and are embedded in the Docs site's page in an inline frame that links to the external source. Official New Relic videos are hosted on [Wistia](//wistia.com). Although Drupal supports embedding from multiple sources, [Vimeo](https://vimeo.com) and [YouTube](https://youtube.com) are the only other video platforms currently enabled.
-
-## Example [#videos]
-
-There are two methods used to embed: a short code method (recommended) and the legacy method. A custom PHP script handles both methods and generates the required markup and scripts to embed the video.
-
-Here is an example of an embedded video:
-
-\[\[wistia|jceickfqyj|optional description]]
-
-Here is an example of the short code you can use to embed a video:
-
-```
-[[wistia |video_id|optional_caption]]
-```
-
-Here is an example of the longer code to embed a YouTube video in an iframe:
-
-```
-<iframe allow="accelerometer; autoplay; encrypted-media; gyroscope; picture-in-picture" allowfullscreen="" frameborder="0" height="315" src="https://www.youtube.com/embed/video_id" width="560"&gt;</iframe>
-```
-
-Include the running time in the caption so users know if they have time to watch it now or later. For an example, see the [Node.js installation documentation](/docs/agents/nodejs-agent/installation-configuration/install-nodejs-agent#video).
+Videos are hosted externally and are embedded in the Docs site's page, linking to the external source. Official New Relic videos are hosted on [Wistia](//wistia.com). 
 
 ## Procedure
 
-To add an embedded video to a document:
+PROCEDURE PENDING...
 
-1. Copy the [short code example](#example) and paste it into your document.
-2. Replace the video_id with your video's ID (located in the parent &lt;div> ID of an existing video or in the Wistia UI).
-3. Verify the running time, and add a caption by inserting the optional_caption in the short code.
-4. For NRU videos, add the following at the end of the caption:
+## Example [#videos]
 
-   ```
-   View more videos and tutorials at learn.newrelic.com.
-   ```
-5. Always test the embedded video before publishing the doc.
+EXAMPLE PENDING...

src/content/docs/new-relic-only/tech-writer-style-guide/processes-procedures/embed-videos.mdx

@@ -15,7 +15,7 @@ watermark: NR ONLY
 This document covers the points that need review when publishing a document, including how to make changes that may be needed for correct publication of a document.
 
 <Callout variant="tip">
-  Some of these features are available only to admins.
+  Some of these features are restricted based on permissions.
 </Callout>
 
 ## Publication checklist [#checklist]
@@ -34,37 +34,6 @@ For new content:
 
 For new documents, make sure:
 
-* The document is living in the right place. See [Renaming and redirecting a document](/docs/new-relic-only/advanced-style-guide/processes-procedures/renaming-redirecting-document).
-* The document has the correct permissions assigned to it.
-* A description and keywords have been set.
-* The sort order is correct.
+* The document is living in the right place, and in the right order with other docs. See [Renaming and redirecting a document](/docs/new-relic-only/advanced-style-guide/processes-procedures/renaming-redirecting-document).
+* The metadata is correct. 
 
-## Check the sort order [#sort-order]
-
-Always confirm sort order when adding or renaming documents. Always use drag and drop to order documents. If items are in order in the **Node order** page but not in the menu, move them out of order and back again. This will force Drupal to renumber all items for that term. This is much easier than worrying about which numbers will and won't work.
-
-<Callout variant="important">
-  Drag and drop doesn't work if you select **Show row weights**.
-</Callout>
-
-Whenever you add a new document or rename an existing doc, Drupal adds to the top list for the assigned taxonomy term. This means it will be the first thing in the menu for that sub-category.
-
-To check the sort order of a document:
-
-1. From the document, select the immediate taxonomy parent in the breadcrumb trail.
-2. Select **> Order Nodes**.
-3. Make sure the documents are in the right order.
-4. Select **Show row weights** to show the row weights.
-5. Make sure none are set to zero.
-6. Select **Hide row weights** to return to drag and drop interface.
-7. Before you check the sort order is the way you want, clear your browser cache.
-
-## Change the sort order [#change-order]
-
-To change the sort order of a document:
-
-1. From the document, select the immediate taxonomy parent in the breadcrumb trail.
-2. Select **Order Nodes**.
-3. Drag the document to the correct position.
-4. Select **Save order**.
-5. Before you check the sort order is the way you want, clear your browser cache.