Re: completed gataxx doc

[Joachim Noreiko <jnoreiko yahoo com>]

--- Ryan Paul <gaerdin gmail com> wrote:

> Hi,
> 
> I just finished the new gataxx docs. I have attached
> a patch to this
> e-mail as well as the complete docbook xml file.
> Comments and criticism
> are appreciated. Did I do everything right?

Yup, it all looks good.

Some points:

* Kill the version number in the manual title -- just
remove ' V&manrevision;' from the <title> tag (this is
something nearly all older docs suffer from by the
way)
* I agree with whoever said we don't need the
screenshot of the main window.
* Furthermore, in 2.14 the look of ataxx has been
radically improved (ie it's no longer impossibly
dark!), so the one showing the possible moves needs to
be redone.
* I'd remove the preferences screenshot too, as I
don't think it adds anything. The user can easily see
the real thing for himself.
* Nitpick zone: the application tag is used in the
overall manual title but not in the subheadings, eg
'<title>Customizing Ataxx</title>'. However, I'm not
sure which way round is correct, as I've seen a bit of
both in our docs. Shaun, any thoughts on this? My gut
feeling is that the title is already emphasized (then
again, I'm not sure why the name of an app needs to be
italicized throughout anyway)

I'm happy to make these final tweaks myself and then
commit :) -- though I'd appreciate someone supplying
me with the scrneenshot of the possible moves. Perhaps
this is a good time to use cropping and fading as
discussed here:
http://bugzilla.gnome.org/show_bug.cgi?id=348495

Joachim





	
	
		
___________________________________________________________ 
Win tickets to the 2006 FIFA World Cup Germany with Yahoo! Messenger. http://advision.webevents.yahoo.com/fifaworldcup_uk/