TYPO3-Documentation / TYPO3CMS-Reference-CoreApi

"TYPO3 Explained": Main TYPO3 Core Document: Main classes, Security, TypoScript syntax, Extension API and much more
https://docs.typo3.org/m/typo3/reference-coreapi/master/en-us/
21 stars 376 forks source link

SEO - improve findability of some key features: TSFE #2666

Closed sypets closed 1 year ago

sypets commented 1 year ago

Edit: Issue was updated.

Right now, when searching for TSFE on Google, these are my first hits:

  1. TYPO3 9, Page TSconfig: https://docs.typo3.org/m/typo3/reference-tsconfig/9.5/en-us/PageTsconfig/Tsfe.html
  2. community resource
  3. community resource
  4. ...

Problem with result 1: is old page, and you can't switch with version selector to newer page (which is correct, because functionality was removed). Also Page TSconfig is probably not the most relevant thing here. See also https://github.com/TYPO3-Documentation/TYPO3CMS-Reference-TSconfig/issues/331

Problem with (some of the) community resources: are not always kept updated and often do not list TYPO3 versions for which this applies, are sometimes in German, most often do not have a version selector. (A nice exception which show TYPO3 versions are pages by Sebastian Klein, Daniel Goerz and Daniel Siepmann)

todos

This should "catch" some of the search engine results (hopefully "outranking" the outdated TSconfig page) and provide missing information and cross links.

Resources

documentation Pages about TSFE (directly or slightly related):

other sources which use TSFE

DavidBruchmann commented 1 year ago

Currently I can switch the version on your 1st search result https://docs.typo3.org/m/typo3/reference-tsconfig/9.5/en-us/PageTsconfig/. Does this solve the issue perhaps already?

sypets commented 1 year ago

Currently I can switch the version on your 1st search result https://docs.typo3.org/m/typo3/reference-tsconfig/9.5/en-us/PageTsconfig/. Does this solve the issue perhaps already?

I don't think so. The TSFE one is this one: https://docs.typo3.org/m/typo3/reference-tsconfig/9.5/en-us/PageTsconfig/Tsfe.html

DavidBruchmann commented 1 year ago

Ok, I see, the TSFE page is missing for versions 10, 11 and main.

Did you see this change?

https://docs.typo3.org/c/typo3/cms-core/main/en-us/Changelog/10.0/Breaking-88564-PageTSconfigSettingTSFEconstantsRemoved.html?highlight=tsfe

sypets commented 1 year ago

Yes, it has been removed in the newer versions. That is not the problem. The problem is (or may be),

There is an easy fix for this, but it is also a general thing that can be addressed.

The easy fix can be:

I have assigned myself the issue. I will take a look.