first commit

typo3/sysext/seo/Documentation/GeneralRecommendations/Index.rst

@@ -0,0 +1,51 @@
+.. include:: ../Includes.txt
+
+
+.. _recommendations:
+
+=======================
+General Recommendations
+=======================
+
+.. _recommendations_extensions:
+
+Recommendations for additional seo extensions
+=============================================
+
+The TYPO3 core ships the whole API and the needed fields to have all necessary technical SEO.
+
+Besides that, there are lots of tools you can use to optimize your rankings.
+
+If you install additional SEO extensions in TYPO3 make sure you check the following recommendations:
+
+* The extension **should** stick to the core fields where possible
+* The extension **should** stick to the core behaviour where possible
+* The extension **could** extend TCA with additional helpers for your editors, like:
+
+  * Readability checks
+  * Keyword and content checks
+  * Previews
+  * Page speed insights
+
+Some of these tools might need external services, others can work completely on-premise.
+
+.. _recommendations_field_description:
+
+Recommendations for the description field
+=========================================
+
+.. danger::
+
+   Current state of SEO research states that the description should be either lovely crafted by hand,
+   of left our completely. (end of 2019)
+
+   If you are unsure contact an expert.
+
+.. youtube:: W4gr88oHb-k
+
+* Duplicate meta descriptions should only be used under specific circumstances
+* Duplicate meta descriptions should only be used on a few pages
+* Leave the description empty if you do not can provide one
+* Provide an engaging explanation of your page, to ensure people will be motivated to visit your site
+* If SEO is not your thing, get professional help
+