[jira] [Commented] (DOXIASITETOOLS-174) rename site.xml root tag from "project" to "doxia-decoration"

["Michael Osipov (JIRA)" <ji...@apache.org>]

    [ 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)