Skip to content

Commit 0eda5eb

Browse files
author
Chris Cho
authored
Merge pull request #158 from ccho-mongodb/113023-add-admonition-meta-keywords
Add mention of taxonomy tagging instructions
2 parents 3372947 + 8a7d4d5 commit 0eda5eb

File tree

1 file changed

+17
-9
lines changed

1 file changed

+17
-9
lines changed

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

Lines changed: 17 additions & 9 deletions
Original file line numberDiff line numberDiff line change
@@ -7,18 +7,26 @@ Page Metadata Directives
77
meta
88
----
99

10-
Use ``.. meta::`` to add |html| meta tags to a page. Adding meta tags
11-
aids in searches both internally and through the Internet. You can add
12-
both keywords and descriptions. To learn more, see
13-
:ref:`seo-guidelines`.
10+
Use ``.. meta::`` to add |html| ``<meta>`` tags to a page. These tags are not
11+
provide other systems such as web browsers, search engines, and other web
12+
services, with information about the page.
13+
14+
You can specify the ``keywords`` and ``description`` name attributes, which
15+
can help indexing pages on internal and external search engines. To learn
16+
more about how to use these name attributes, see :ref:`seo-guidelines`.
17+
18+
.. important::
19+
20+
MongoDB Technical Writers should use the meta keyword standards defined in
21+
the "Taxonomy Tagging Instructions" internal wiki page.
1422

1523
.. code-block:: rst
16-
17-
.. meta::
18-
:keywords: read concern, local read concern, read isolation, transactions, multi-document transactions
19-
:description: You can tune the consistency and availability of your application using write concerns and read concerns.
2024

21-
Add the ``.. meta::`` directive on the line below the
25+
.. meta::
26+
:keywords: read concern, local read concern, read isolation, transactions, multi-document transactions
27+
:description: You can tune the consistency and availability of your application using write concerns and read concerns.
28+
29+
Add the ``.. meta::`` directive on the line below the
2230
page title with a line break in between.
2331

2432
Learn more about the ``meta`` directive from the

0 commit comments

Comments
 (0)