[kde-doc-english] Re: Kontact documentation

[Philip Rodrigues]

Hi Antonio,

> Well, here (attached) is the .tar.gz archive with the updated Kontact
> documentation and all the screenshots (because there are actually
> screenshots in this one). Let me know what you think, and, of course, fire
> away with the proofreaders...

Looks good! I've made some changes to the markup, mainly changing a few 
'presentation' things to 'content' things. A great tag is <replaceable>, 
which I've used (inside <guilabel>s, mainly) to show something that is a 
placeholder, and will be replaced by the real value.

You should add yourself at least in the 'credits and license' section, and 
probably in the <bookinfo> section too. I changed the <date> to the current 
date (you should do this each time you modify the document - it helps the 
translators). I don't have Kontact from CVS HEAD at the moment, so I couldn't 
find the correct version of the application to <releaseinfo>. You should 
change that.

We don't usually link to other documents inside docbook files, because we 
can't be sure they exist on the user's system, but in this case, I think we 
can be reasonably certain that the rest of kdepim will be installed. So I 
guess it's OK to have the links (and they're very useful for the content). 
Does anyone else here have an opinion?

Please feel free to ask about any changes I've suggested, and to disagree with 
them if you want :-).

(I'm not sure if it's just because I'm on a small screen here, but the 
screenshots seem to be quite large. Would it be easy to resize the Kontact 
window and retake them?)

> PS: For future reference, how large is 'quite large'? :-)

I guess >500KB is 'quite large' (well, www.ntk.net seems to think so :-).

Again, thanks for the good work, and any questions, don't hesitate to ask,
Regards,
Philip
-------------- next part --------------
A non-text attachment was scrubbed...
Name: index.docbook
Type: text/docbook
Size: 24664 bytes
Desc: not available
Url : http://mail.kde.org/pipermail/kde-doc-english/attachments/20040426/dd64854f/attachment.bin 
-------------- next part --------------
A non-text attachment was scrubbed...
Name: not available
Type: application/pgp-signature
Size: 187 bytes
Desc: signature
Url : http://mail.kde.org/pipermail/kde-doc-english/attachments/20040426/dd64854f/attachment.sig