[kde-doc-english] releaseinfo naming scheme for docbooks in Frameworks/Workspace/Applications

Burkhard Lück lueck at hube-lueck.de
Sun Jun 14 12:44:13 UTC 2015


Am Samstag, 13. Juni 2015, 16:13:29 schrieb Luigi Toscano:
> Burkhard Lück ha scritto:
> > Hi,
> > 
> > we should have a consistent naming scheme for <releaseinfo> markup in our
> > docbooks in kf5:
> > 
> > <releaseinfo>Frameworks x.y</releaseinfo>
> > 
> > <releaseinfo>Plasma x.y</releaseinfo> used 36x already in master
> > 
> > <releaseinfo>Applications xx.yy</releaseinfo>
> > 
> > No ".z"
> > 
> > Comments/Improvements/etc please
> 
> +1 to the above
> For applications with independent release schedule, should we use
> <releaseinfo>$applicationname xx.yy</releaseinfo>
> or simply
> <releaseinfo>xx.yy</releaseinfo>
> ?
> 
"applications with independent release schedule" = extragear+playground ?
Then I'd prefer <releaseinfo>$applicationname xx.yy</releaseinfo>, because it 
is obvious that xx.yy is the version of $applicationname 

> Also, as we are talking about global changes related to the new release
> policy, we should also change all occurencies "K Desktop Environment" around
> (man pages, documentation keywords, etc) with (depending on the case)
> either the name of the application/component or KDE.org, maybe.
> 
+1

-- 
Burkhard Lück



More information about the kde-doc-english mailing list