You are viewing a plain text version of this content. The canonical link for it is here.
Posted to issues@maven.apache.org by "Hervé Boutemy (JIRA)" <ji...@apache.org> on 2016/04/01 02:11:25 UTC

[jira] [Commented] (DOXIASITETOOLS-164) don't use document date from Sink API as creation date but as "date" without precision on created or last modified

    [ https://issues.apache.org/jira/browse/DOXIASITETOOLS-164?page=com.atlassian.jira.plugin.system.issuetabpanels:comment-tabpanel&focusedCommentId=15220901#comment-15220901 ] 

Hervé Boutemy commented on DOXIASITETOOLS-164:
----------------------------------------------

I agree in general with your remarks: the only part I'm not ok is "Pages are updated with releases only": pages are updated or not with releases, they are only published with releases (be it modified or not). And there is the case of a site without code, which has no release (like Maven site or Doxia site)

IMHO, the issue has to be fixed in Doxia first, in every markup language): in Doxia Siterenderer, it's too late to change anything
and definitely DOXIASITETOOLS-20 created a qui pro quo since it said the semantics was defined when it was not, as the discussion on the mailing list showed: for Dennis, apt date is clearly a modification date (even if not exactly "last modified", but more "last sufficiently modified that the dev takes time to update")

then the only solution I see is stop lying: document the issue and show that Doxia document date is "a date" and that nobody agrees on general semantics

do you have any better idea?

> don't use document date from Sink API as creation date but as "date" without precision on created or last modified
> ------------------------------------------------------------------------------------------------------------------
>
>                 Key: DOXIASITETOOLS-164
>                 URL: https://issues.apache.org/jira/browse/DOXIASITETOOLS-164
>             Project: Maven Doxia Sitetools
>          Issue Type: Bug
>          Components: Site renderer
>    Affects Versions: 1.7
>            Reporter: Hervé Boutemy
>             Fix For: 1.7.1
>
>
> as seen in DOXIA-541, the meaning of the date is not defined in Doxia: then it seems it's up to the content writer to choose...
> and it was a wrong choice to name the content of date field of the document as {{dateCreation}} variable in DOXIA-315 / DOXIASITETOOLS-20 [r771801|http://svn.apache.org/r771801] in 2009
> let's start by showing the weak sematic before choosing what to do: creation date, last modification date, or even add some more features like multiple dates (for example "created : last modified")?



--
This message was sent by Atlassian JIRA
(v6.3.4#6332)