On Saturday 21 April 2007 14:07, Larry Battraw wrote:
> Looks pretty good to me as-is.  The only change I might suggest is to
> provide more instructions on starting IRKick (where it's located with
> the 'K' menu structure) and a example on binding a key within the
> "IRKick support" section

I haven't read the document closely yet, and I discover my only copy of 
Pedro's email is on another computer now (I'm an idiot).  But I did glance at 
it, and I did notice one bug -- it refers to LIRC before defining it.  The 
introductory paragraph needs to be clearer about what exactly is doing what, 
and why.  I think something similar may have been the case about the 
references to IRKick.

I don't think this document should go verbatim into the Handbook, because much 
of it is about setting up your system and the Handbook doesn't deal with 
that.  I would probably keep the text file in the RG tree, put a txt2html 
version of it on the website (like the FAQ etc), and put a three-paragraph 
summary into the Handbook describing how to use it and where to find the 
documentation about configuring it.  The first two parts of that could be 
nicely made obsolete by someone finding the time to set up a Rosegarden wiki, 
of course.

Half of the battle with features documentation is telling the user that a 
feature exists at all, and the Handbook is the obviously ideal place for 
that.  Assuming they ever discover that the Handbook ever exists at all...


Chris

-------------------------------------------------------------------------
This SF.net email is sponsored by DB2 Express
Download DB2 Express C - the FREE version of DB2 express and take
control of your XML. No limits. Just data. Click to get it now.
http://sourceforge.net/powerbar/db2/
_______________________________________________
Rosegarden-devel mailing list
[email protected] - use the link below to unsubscribe
https://lists.sourceforge.net/lists/listinfo/rosegarden-devel

Reply via email to