Task #90503
closedSEO documentation improvements
100%
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
- update the screenshot to use a domain
- 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`
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. ;-)
Updated by Sybille Peters 6 months ago
ok. Let me know if you would like feedback from me.
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
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
Updated by Garvin Hicking 5 months ago
- Related to Task #91939: Where is configuration of plugin.tx_seo TS in sysext seo docs? added
Updated by Sybille Peters 5 months ago
- Subject changed from SEO documentation: site configuration to SEO documentation improvements
- Description updated (diff)
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
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
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
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
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
Updated by Garvin Hicking 4 months ago
- Status changed from Under Review to Resolved
- % Done changed from 0 to 100
Applied in changeset 1c4c76647878b19bed348c7fc31a6aeddd1fe301.