(DOCSP-29016): Added SEO guidelines.

Author: corryroot

source/style-guide.txt

@@ -38,6 +38,10 @@ MongoDB external and internal customers.
    MongoDB products. You can use these basic guidelines,
    however, when writing release notes for any product or service.
 
+:doc:`/style-guide/seo-guidelines`
+   Provides guidance for optimizing your documentations pages for 
+   search.
+
 :github:`User Interface Guidelines </mongodb/leafygreen-ui>`
    Provides specifications for the user interface of MongoDB web and
    desktop applications. The components can be viewed
@@ -56,6 +60,7 @@ MongoDB external and internal customers.
       /style-guide/screenshots/index
       /style-guide/error-message-guidelines
       /style-guide/release-notes-guidelines
+      /style-guide/seo-guidelines
       /style-guide/revision-history
 
 The |mdbsg| includes material from the following:

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

@@ -1,20 +1,30 @@
+.. _metadata:
+
 ========================
 Page Metadata Directives
 ========================
 
+.. default-domain:: mongodb
+
 meta
 ----
 
-Generates HTML ``<meta>`` tags.
+Use ``.. meta::`` to add |html| meta tags to a page. Adding meta tags 
+aids in searches both internally and via the Internet. You can add both 
+keywords and descriptions. To learn more, see :ref:`seo-guidelines`.
 
 .. code-block:: rst
+	     
+	   .. meta::
+	      :keywords: read concern, local read concern, read isolation, transactions, multi-document transactions
+	      :description: You can tune the consistency and availability of your application using write concerns and read concerns.
 
-   .. meta::
+Add the ``.. meta::`` directive on the line below the 
+``.. default-domain::`` directive with a line break in between.
 
 Learn more about the ``meta`` directive from the
 `{+docutils+} documentation <http://docutils.sourceforge.net/docs/ref/rst/directives.html#meta>`__.
 
-
 title
 -----
 

source/style-guide/seo-guidelines.txt

@@ -0,0 +1,84 @@
+.. _seo-guidelines:
+
+=====================================
+Search Engine Optimization Guidelines
+=====================================
+
+.. default-domain:: mongodb
+
+Search Engine Optimization (SEO) considers the actual terms that users 
+enter into serach 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.
+
+Titles
+------
+
+Title pages and subsections according to the following SEO best 
+practices:
+
+- Use a maximum of 70 characters.
+
+- Include target keywords.
+
+- Avoid excessive or irrelevant words (keyword stuffing).
+
+- Use a unique title for every page.
+  
+To learn more, see :ref:`titles-and-headings`.
+
+Alternative Text
+----------------
+
+Screen readers read alternative text aloud so that users can better
+understand an on-page image. Specify alterative text according to the 
+following SEO best practices:
+
+- Use a maximum of 125 characters per image.
+
+- Describe the image with specific language.
+
+- If it makes sense, include keywords.
+
+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.
+
+- 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”.
+
+To learn more, see :ref:`metadata`.
+
+Descriptions
+------------
+
+The snippet that appears under the link in the search results can 
+impact SEO. Write these descriptions according to the following best 
+practices:
+
+- Make the descriptions informative (and enticing if possible).
+
+- Emphasize the “why” for using the page.
+
+- Use a maximum of 155 characters.
+
+- Include target keywords and a call to action.
+
+- Keep the description short, simple, and concise. 
+
+- Concisely, explain the page content.
+
+- Use unique meta descriptions for every page.
+
+To learn more, see :ref:`metadata`.