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

[Albert Astals Cid]

El Dimarts, 3 de febrer de 2015, a les 20:37:54, Yuri Chornoivan va escriure:
> написане Tue, 03 Feb 2015 20:33:56 +0200, Albert Astals Cid
> 
> <aacid at kde.org>:
> > 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
> 
> Yes. I'm sure that Burkhard has already proposed to fix dates. And yes, it
> does not used in our workflow so nothing important in KDE depends on ISO
> dates in docs. ;)

I'm not saying that Burkhard did not propose or not to fix the dates, i'm 
asking if he was the one that originally proposed it in 2005, since your "it 
was a proposal" seems he wrote the original text (which svn seems to disagree 
but may be since it's part of a huge blob)

Cheers,
  Albert

> 
> Best regards,
> Yuri
> 
> >> 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