(DOCSP-36143): Aligned SEO guidance with Taxonomy instructions. (#167)

* (DOCSP-36143): Aligned SEO guidance with Taxonomy instructions.

* (DOCSP-36143): Incorporated feedback.

* (DOCSP-36143): Incorporated Chris's feedback.

Author: corryroot

source/style-guide/markup/directives/metadata.txt

@@ -13,12 +13,12 @@ services, with information about the page.
 
 You can specify the ``keywords`` and ``description`` name attributes, which
 can help indexing pages on internal and external search engines. To learn
-more about how to use these name attributes, see :ref:`seo-guidelines`.
+more, see :ref:`seo-guidelines`.
 
 .. important::
 
-   MongoDB Technical Writers should use the meta keyword standards defined in
-   the "Taxonomy Tagging Instructions" internal wiki page.
+   Use the meta keyword tag standards defined in the 
+   `Taxonomy tagging instructions <https://wiki.corp.mongodb.com/display/DE/Taxonomy+tagging+instructions>`__. 
 
 .. code-block:: rst
 

source/style-guide/seo-guidelines.txt

@@ -7,7 +7,52 @@ Search Engine Optimization Guidelines
 Search Engine Optimization (SEO) considers the actual terms that users 
 enter into search engines (keywords) and employs best practices to 
 improve traffic to web pages from search engines. The following 
-guidance should help you optimize your documentation pages for search.
+guidance helps you to optimize your documentation pages for search.
+
+.. important::
+
+   In addition to this guidance, our content taxonomy improves 
+   findability and increases relevance for search queries. To learn 
+   more about the instructions and best practices for our content 
+   taxonomy, see the `Taxonomy tagging instructions 
+   <https://wiki.corp.mongodb.com/display/DE/Taxonomy+tagging+instructions>`__. 
+
+Keywords
+--------
+
+You can add the actual terms that users enter into search engines 
+(keywords) to the body of your page to improve its SEO.
+
+.. important::
+  
+   This guidance makes a distinction between the terms "keywords" and 
+   "keyword meta tags". Here "keywords" are popular search terms added 
+   throughout the content body, and "keyword meta tags" are metadata 
+   specified with the ``.. meta::`` directive. While "keyword meta 
+   tags" are available, some search engines might ignore these tags. To 
+   learn more about "keyword meta tags", see :ref:`metadata`. We 
+   primaily use "keyword meta tags" to supplement our taxonomy. To 
+   learn more about the instructions and best practices for "keyword 
+   meta tags", see the `Taxonomy tagging instructions 
+   <https://wiki.corp.mongodb.com/display/DE/Taxonomy+tagging+instructions>`__.
+
+Add keywords throughout the page copy according to the following best 
+practices:
+
+- Take the most concise form of the information that the page conveys 
+  and make that the target keyword.
+
+- Avoid keywords so broad that they compete with the product page.
+
+- Avoid keywords so specific that we miss the actual behavior of 
+  our searchers.
+
+.. example::
+
+   If the terms that people search for to try to find a page are 
+   "MongoDB Atlas Course", add that phrase in at least one spot. For 
+   example, use "This MongoDB Atlas course..." instead of "This Getting 
+   Started with Atlas course...".
 
 Titles
 ------
@@ -16,8 +61,8 @@ Use the following SEO best practices for page and subsection titles:
 
 - Use a maximum of 70 characters.
 
-- Include target keywords (the actual terms that users 
-  enter into search engines to reach your page).
+- Include target keywords (the most concise form of the information 
+  that the page conveys).
 
 - Avoid excessive or irrelevant words (keyword stuffing).
 
@@ -42,31 +87,6 @@ following SEO best practices:
 
 To learn more, see :ref:`write-for-accessibility`.
 
-Keywords
---------
-
-You can add the actual terms that users enter into search engines 
-(keywords) to your page to improve its SEO. Add keywords according to 
-the following best practices:
-
-- Take the most concise form of the information that the page conveys 
-  and make that the target keyword.
-
-  .. example::
-
-     The target keyword for the `Getting Started with MongoDB Atlas 
-     <https://learn.mongodb.com/courses/getting-started-with-mongodb-atlas>`_ University page is 
-     ``mongodb atlas course``.
-
-- Don't add keywords so broad that they compete with the product page.
-
-- Don't add keywords so specific that we miss the actual behavior of 
-  our searchers. For example, add “mongodb atlas course” instead of 
-  “Getting Started with Atlas Data Platform”.
-
-While keyword tags are available, some search engines might ignore 
-these tags. To learn more, see :ref:`metadata`.
-
 Descriptions
 ------------