Introduce &productnameshort; entity

[tomschr]

PR creator: Description

Introduce &productnameshort; entity as discussed in SLE Writers Call on 2022-11-21.

Tahlia, if you are okay with the change, I will take care of cherry-picking it into the different branches.

PR creator: Are there any relevant issues/feature requests?

• DOCTEAM-828

PR creator: Which product versions do the changes apply to?

• SLE-HA 15
  • 15 next: eeba8f2
  • 15 SP4: 609e5d1
  • 15 SP3: 025cbed
  • 15 SP2: a496a76
  • 15 SP1: 7fbce06
  • 15: 8c75688
• SLE-HA 12
  • 12 SP5: 5cfbdb4
  • 12 SP4: d0a1424

PR reviewer only: Have all backports been applied?

The doc team member merging your PR will take care of backporting to older documents.
When opening a PR, do not set the following check box.

• all necessary backports are done

[tahliar]

Does it also need to go in the article_*.xml files, or is it not needed there because of book_quickstarts.xml?

[tomschr]

Does it also need to go in the article_*.xml files, or is it not needed there because of book_quickstarts.xml?

If every article is incorporated through the set, it is enough to have it inside the MAIN file. The stylesheets climb up the ancestor nodes up to <set> and extract the information from the set/info element.

If I recall correctly, in former SPs, some articles were independent from MAIN (not included). In such a case, the information needs to go into the respective article of course.

[tomschr]

I looked in the different maintenance branches with the command grep MAIN DC-* | cut -d '=' -f2 | sort | uniq:

• 15 SP4: only MAIN.SLEHA.xml
• 15 SP3: only MAIN.SLEHA.xml
• 15 SP2: only MAIN.SLEHA.xml
• 15 SP1: only MAIN.SLEHA.xml
• 15 GA: only MAIN.SLEHA.xml
• 12 SP5: only MAIN.SLEHA.xml
• 12 SP4: art_sle_ha_geo_quick.xml, art_sle_ha_install_quick.xml, book_sle_ha_geo.xml, MAIN.SLEHA.xml

I wasn't that wrong. 😉 Only for 12 SP4 we need to take care to insert the <productname role="abbrev"> element in the respective MAIN file.

[tomschr]

@tahliar All cherry-picking are done, the respective commits are added in the original description.
As mentioned in my last comment, for 12 SP4 I've inserted the additional <productname role="abbrev"> for every article. We should be on the safe side now.