[DOXIASITETOOLS-254] Clarify inconsistencies in Doxia site model

• Type: Task
• Status: Closed
• Priority: Major
• Resolution: Fixed
• Affects Version/s: 1.11.1
• Fix Version/s: 2.0.0-M12, 2.0.0
• Component/s: Site model
• Assignee: Michael Osipov
• Reporter: Michael Osipov
• Created: 08/May/22 13:13
• Updated: 20/May/24 09:40
• Resolved: 01/Oct/23 17:52

Description

https://maven.apache.org/doxia/doxia-sitetools-archives/doxia-sitetools-1.11.1/doxia-decoration-model/decoration.html

bannerLeft/bannerRight (see also DOXIASITETOOLS-253):

• Are name and src (image) mutually exclusive? If yes, in what order should they appear? Why is no position like with other similar elements (logo, item)?
• Does href truly only apply to the image?
• Why is there no target?
• Must title/alt only be used on the image?
• Why not apply here the same logic as with the other imaged elements?
• Why src instead of img like the rest?
• Why does it use subelements and not attributes like the rest?

logo/link item/menu/menu item:

• Does href truly only apply to the text? (different to banner)
• Must title/alt only be used on the image?

Issue Links

• is a parent of: DOXIASITETOOLS-253 Clarify "border", "width" and "height" for Banner and LinkItem
• Is contained by: DOXIASITETOOLS-311 Rework and simplify the site model
• is depended upon by: MSKINS-170 Allow to show name as headline in addition to bannerLeft
• relates to: DOXIASITETOOLS-31 Allow images in the menu items of the site.xml