maven-issues mailing list archives

Site index · List index
Message view « Date » · « Thread »
Top « Date » · « Thread »
From Hervé Boutemy (JIRA) <j...@apache.org>
Subject [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
Date Fri, 01 Apr 2016 00:11:25 GMT

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

Mime
View raw message