[kde-doc-english] Wrong ISO dates in docbook files

Albert Astals Cid aacid at kde.org
Tue Feb 3 18:33:56 UTC 2015


El Dimarts, 3 de febrer de 2015, a les 12:17:44, Yuri Chornoivan va escriure:
> написане Mon, 02 Feb 2015 23:45:47 +0200, Albert Astals Cid
> 
> <aacid at kde.org>:
> > El Diumenge, 1 de febrer de 2015, a les 02:36:06, Eloy Cuadra va
> > 
> > escriure:
> >> Hi,
> >> 
> >> I don't know if this is really important but in the docbook's author
> >> guide
> >> (http://l10n.kde.org/docs/markup/index.html) we can read in the page
> >> about
> >> the Prologue section (http://l10n.kde.org/docs/markup/prologue.html)
> >> that
> >> 
> >> the <date> field must contain only ISO dates in the form "yyyy-mm-dd":
> >>   <date>
> >>   
> >>     The date is very important. It is used not only by scripts for
> >> 
> >> automatic
> >> processing of documentation, but is also central to revision control and
> >> co-ordination of translations. You must change the date if you have
> >> changed
> >> the original document, and you must not change the date if you are a
> >> translator. The format of the date is very important. It must be in the
> >> ISO, with “literal” delimiters, in the form “yyyy-mm-dd”. Please be
> >> extremely careful about this, and triple check it before you send in the
> >> document.
> >> 
> >> Well, the KDE's original docbook files are plenty of dates that don't
> >> follow
> >> this rule (and also the corresponding translated PO files).
> >> 
> >> Is it advisable to fix this issue now? This issue concerns a lot of
> >> english
> >> documentation in both stable and trunk branches (for kde4 and kf5).
> > 
> > That's a good question. Had a look at the docbook documentation on
> > http://www.docbook.org/tdg/en/html/date.html and it says there's no
> > expected
> > format for the date.
> > 
> > So i guess this may have been a self-imposed version so that people knew
> > what
> > to translate from.
> > 
> > I looked in svn but the commit that introduced that sentence doesn't say
> > anything about it and Nicolas doesn't seem to be around anymore to
> > answer the
> > question.
> > 
> > So i guess we should decide ourselves, do we want to enforce that or not?
> > 
> > Cheers,
> > 
> >   Albert
> > 
> > P.S: CC'ed the kde-doc-enlgish ml
> > 
> >> Cheers
> 
> Hi,
> 
> That's not the first time when this question arises. It was a proposal by
> Burkhard to have a consistent date/time format.

You sure? That text is back from 2005 or something.

Cheers,
  Albert

> 
> There were no objections to this. I think anyone with git access can fix
> the dates if found this appropriate without a confirmation.
> 
> Best regards,
> Yuri
> _______________________________________________
> kde-doc-english mailing list
> kde-doc-english at kde.org
> https://mail.kde.org/mailman/listinfo/kde-doc-english



More information about the kde-doc-english mailing list