[Kde-games-devel] Call for a documentation update

[Burkhard Lück]

Am Montag, 1. Februar 2010 09:14:25 schrieb Burkhard Lück:
> Am Dienstag, 26. Januar 2010 22:34:37 schrieb Burkhard Lück:
> > Am Dienstag, 19. Januar 2010 23:47:50 schrieb Burkhard Lück:
> > > Hi kdegames devels,
> > >
> > > kdegames was the *only* module in kde 4.0 with a completely up to date
> > > documentation :)
> > > Great job!
> > >
> > > As you can see on
> > > http://techbase.kde.org/Projects/Documentation/KDE4_(health_table)#kdeg
> > >am es , nearly all games are rated Up-to-date, but at least a lot of
> > > screenshots should be retaken.
> > >
> > > This is a call to any devel of a kdegames application:
> > >
> > > * review/proofread and update your doc and the screenshots
> > >   update <date> and <releaseinfo> and commit to trunk
> > >
> > > * update KDE4_(health_table)#kdegames for your game and add the comment
> > >   "Update is in trunk, backport to kde 4.4".
> > >
> > > The new kde-i18n-doc doc string freeze policy allows a backport of docs
> > >  from trunk in the first week after tagging a release.
> > >
> > > I will care for these backports.
> > >
> > > So if you update your docs soon w'll have them at least in kde 4.4.1
> >
> > Hmm, I saw an update for kpat, kdiamond, kmahjongg and ksirk seems to be
> >  work in progress, but what about the other 30 games?
> > The documentation and the screenshots for all of them are up to date for
> >  4.4?
> >
> > Really?
> >
> > In that case please update at least <date> and <releaseinfo> data in your
> > docs.
> >
> > Thanks.
> 
> A quick check of games b* to ki* in kdegames trunk:
> 
> KBattleship:
> The other player has to choose Connect to network game, or click
>  Game->Connect to Game.... Again, a Nickname: is suggested, but you can
>  choose any name you like. In the field Hostname: you have to enter the
>  host name of the server (the machine of the player that initiated the
>  game).
> -> Wrong
> you can try out GGZ by visiting the community site.
> ggz://live.ggzgamingzone.org#Battleship -> broken link
> Settings menu -> some items missing
> 
How to fix that in the docs?

> KBlackBox
> Settings menu -> some items missing
> 
> KBreakout Pause + Full Screen Mode menu items missing
> 
> KDiamond no Settings->Difficulty any more
> move explanation of levels to ??
> 
This is fixed now - in the code!

> KGoldrunner
> Level Selection Dialog Box screenshot looks outdated
> The Themes Menu -> different order of items
> 
> Kigo
> Game->Start (S) is now Game->Start Game (S)
> Game->Finish (F) is  Game->Finish Game (F)
> 
Fixed

> Kiriki
> Version changed to 0.2
> 
Fixed

> Please change all
> <sect1 id="foo">
> <title>The <guimenu>Foo</guimenu> Menu</title>
> to
> <sect1 id="foo">
> <title>The Foo Menu</title>
> With the guimenu markup it looks really ugly in the new header of the
> documentation.
> 
OnlxY a few days left to make it into 4.4.1, all other changes/corrections 
can't go into branch before 4.4.2.

-- 
Burkhard Lück