Project

General

Profile

Actions

Task #90503

closed

SEO documentation improvements

Added by Sybille Peters over 4 years ago. Updated about 1 month ago.

Status:
Closed
Priority:
Should have
Category:
Documentation
Target version:
-
Start date:
2020-02-23
Due date:
% Done:

100%

Estimated time:
TYPO3 Version:
10
PHP Version:
Tags:
Complexity:
Sprint Focus:

Description

Generally clean up what should be in EXT:seo docs and what should be in TYPO3 Explained, add missing and use same terms as in configuration.

Sort out what is documented in EXT:seo docs and what is in TYPO3 Explained

Some core configuration / features is documented in ext:seo and some ext:seo documentation is documented in "TYPO3 EXplained".

The indended state is:

  • general TYPO3 stuff in TYPO3 explained with focus on development (but also configuration can be explained here, as in site handling)
  • things that are system extension specific: ext:seo documentation

For more details, see https://forge.typo3.org/issues/90504

Document plugin.tx_seo in EXT:seo

see https://forge.typo3.org/issues/91939

Use the same terms in the text as in the configuration

I would use the same terms as in the "Site Configuration" module.

Example:

In the section Domains (in TypoScript settings) there is a warning:

Please ensure, that you have configured your sites so that they all have an entry point. This is used for generating the canonical tags, for example.

Warning

Please be aware that for SEO purposes it is best practise to use a fully qualified domain (for example: https://www.example.com). Therefor we don’t support the SEO enhancements in TYPO3 without a full domain. It might work, but it is not officially supported.

"use a fully qualified domain" where? I guess it is meant in the site configuration tab "General" "Entry Point" from the context, but the screenshot above does not use a FQDN, just /.

So I would

  1. update the screenshot to use a domain
  2. use the same terms in the text as in the configuration (and screenshot), e.g.:
  • "General > Entry Point" (instead of "Domains")
  • "Languages" instead of "Language"
  • "Error Handling" instead of "Error pages"

"it is best practise to use a fully qualified domain for the :guilable:`Entry Point`


Related issues 2 (0 open2 closed)

Related to TYPO3 Core - Task #90504: Sort out documentation for SEO: some general things are in ext:seo documentation, some specific ext:seo things in "TYPO3 Explained"Closed2020-02-23

Actions
Related to TYPO3 Core - Task #91939: Where is configuration of plugin.tx_seo TS in sysext seo docs?Closed2020-08-06

Actions
Actions #1

Updated by Georg Ringer over 4 years ago

  • Status changed from New to Accepted
Actions #2

Updated by Sybille Peters about 2 years ago

  • Assignee set to Sybille Peters
Actions #3

Updated by Garvin Hicking 6 months ago

  • Assignee changed from Sybille Peters to Garvin Hicking

Can work on this. I'm out for screenshot regeneration however. ;-)

Actions #4

Updated by Sybille Peters 6 months ago

ok. Let me know if you would like feedback from me.

Actions #5

Updated by Gerrit Code Review 5 months ago

  • Status changed from Accepted to Under Review

Patch set 1 for branch main of project Packages/TYPO3.CMS has been pushed to the review server.
It is available at https://review.typo3.org/c/Packages/TYPO3.CMS/+/84618

Actions #6

Updated by Garvin Hicking 5 months ago

  • Related to Task #90504: Sort out documentation for SEO: some general things are in ext:seo documentation, some specific ext:seo things in "TYPO3 Explained" added
Actions #7

Updated by Garvin Hicking 5 months ago

  • Related to Task #91939: Where is configuration of plugin.tx_seo TS in sysext seo docs? added
Actions #8

Updated by Sybille Peters 5 months ago

  • Subject changed from SEO documentation: site configuration to SEO documentation improvements
  • Description updated (diff)
Actions #9

Updated by Gerrit Code Review 5 months ago

Patch set 2 for branch main of project Packages/TYPO3.CMS has been pushed to the review server.
It is available at https://review.typo3.org/c/Packages/TYPO3.CMS/+/84618

Actions #10

Updated by Gerrit Code Review 4 months ago

Patch set 3 for branch main of project Packages/TYPO3.CMS has been pushed to the review server.
It is available at https://review.typo3.org/c/Packages/TYPO3.CMS/+/84618

Actions #11

Updated by Gerrit Code Review 4 months ago

Patch set 1 for branch 12.4 of project Packages/TYPO3.CMS has been pushed to the review server.
It is available at https://review.typo3.org/c/Packages/TYPO3.CMS/+/85240

Actions #12

Updated by Gerrit Code Review 4 months ago

Patch set 4 for branch main of project Packages/TYPO3.CMS has been pushed to the review server.
It is available at https://review.typo3.org/c/Packages/TYPO3.CMS/+/84618

Actions #13

Updated by Gerrit Code Review 4 months ago

Patch set 2 for branch 12.4 of project Packages/TYPO3.CMS has been pushed to the review server.
It is available at https://review.typo3.org/c/Packages/TYPO3.CMS/+/85240

Actions #14

Updated by Garvin Hicking 4 months ago

  • Status changed from Under Review to Resolved
  • % Done changed from 0 to 100
Actions #15

Updated by Benni Mack about 1 month ago

  • Status changed from Resolved to Closed
Actions

Also available in: Atom PDF