Right now, our page <title>:s in the TAG are these very excessive things: > Printer Features — The ThinLinc Administrator's Guide 4.14.0post build 3293 documentation This is very likely to be cropped in usage, so it really should be a more sensible length. Most things will likely crop from the end, though, meaning the important parts are likely not hidden. For comparison, the same page had this title before the switch to ReST: > Chapter 5. Printer Features Much shorter, but lacks any reference to ThinLinc so is likely a bit too short.
Most search engines truncate titles containing more than 70 characters. Incomplete and shortened titles look unappealing to users and won't entice them to click on your page. For more information, please see this Google article: https://developers.google.com/search/docs/appearance/title-link
Another interesting aspect here is that the HTML titles do not work especially well in search engines. For example: https://www.cendio.com/resources/docs/tag/tldc_introduction.html That link shows up as "Introduction — The ThinLinc Administrator's Guide ... - Cendio" in Google, despite it not being a general introduction but rather an introduction to TLDC. This is probably out-of-scope of this issue, but is still something worth considering.
The HTML titles have now been drastically reduced in length. Pierre's example above now looks like this: > Printer features — ThinLinc Administrator's Guide Marking as resolved.
Discussion from https://git.cendio.se/wilsj/guten-tag/-/merge_requests/2 -------------------------- Created by: aeneby Could we even use "TAG" in place of "ThinLinc Administrator's Guide", everywhere except the main/index page? Or would that be too confusing for new users? -------------------------- Created by: williamsjoblom We want to make it clear what these pages are when displayed in search engines. A hit showing up as Server Installation - TAG in Google is probably not the most helpful. Especially as our domain name is cendio.com and not thinlinc.com. Hence -- I'd personally prefer something more verbose. There are some instances where <section> is longer than 36 characters. For example "Building custom Linux desktops with the ThinLinc Desktop Customizer". In my opinion, these overly long titles would benefit from being shortened anyway. I, personally, see shortening those as a separate issue. --------------------------
Tested by accessing the TAG in the browser and can confirm it uses "ThinLinc Administrator's Guide" as its new suffix. Code changes also look good and minimal.
