[
https://issues.apache.org/jira/browse/DOXIASITETOOLS-174?page=com.atlassian.jira.plugin.system.issuetabpanels:comment-tabpanel&focusedCommentId=15873613#comment-15873613
]
Michael Osipov commented on DOXIASITETOOLS-174:
-----------------------------------------------
Hervé, while you reasoning is sound, I think this goes in the wrong direction.
People do not really care about {{decoration-model}} nor most do directly know
Doxia and friends. They know and use Site Plugin and they are happy with. In
fact, {{doxia-decoration}} sounds even more confusing to me. In my opinion the
root element should be {{site}} and the schema filename {{doxia-site.xml}},
{{site.xml}} or {{site-descriptor.xml}}.
> rename site.xml root tag from "project" to "doxia-decoration"
> -------------------------------------------------------------
>
> Key: DOXIASITETOOLS-174
> URL: https://issues.apache.org/jira/browse/DOXIASITETOOLS-174
> Project: Maven Doxia Sitetools
> Issue Type: Wish
> Components: Decoration model
> Affects Versions: 1.7.4
> Reporter: Hervé Boutemy
>
> when looking at [decoration model
> descriptor|http://maven.apache.org/doxia/doxia-sitetools-archives/doxia-sitetools-1.7/doxia-decoration-model/decoration.html],
> naming the root element as {{project}} (like for {{pom.xml}}) is misleading
> if the root element could be renamed as {{doxia-decoration}}, the obvious
> (this descriptor is about site decoration, done with Doxia) could perhaps
> become obvious
> (in IT, calling everything a "project" is an issue...)
> I know that this change of xsd schema will break compatibility, but I think
> it can really make a big difference in usability (and I should have had this
> idea for Doxia Sitetools 1.7, when we already made some breaking changes...)
--
This message was sent by Atlassian JIRA
(v6.3.15#6346)
