Re: [Rosegarden-devel] diff for index.docbook

[Chris C. <ca...@al...>]

Alexandre Prokoudine wrote:
> note editor -> Note editor, where not done

What's the rationale for this change?  On the whole I've avoided
capitalising things in the text I wrote, a decision described in
a comment in the docbook file:

     * Be strict about using the correct terminology for
       Rosegarden data structures (segment, event, track,
       instrument, composition), but don't capitalise the
       words.  Capitalisation is useful in technical documents
       to make it clear that you're referring to a precise
       concept, but you shouldn't have to do it to make your
       meaning clear in user documentation.  If something
       seems ambiguous without, try rewording it instead.

I'm not quite sure whether that should apply to GUI components
as well as to data structures, though.  The intention was that
the user shouldn't have the precise terminology forced down
their throat, only that they should see it used consistently.
But when it comes to GUI stuff there may be an argument for
doing as you have and capitalising more often (after all, we
always capitalise menu names and the like).  Hmm.

Apart from that, my only complaint is that when I wrote "--" as
a dash between phrases, I intended an em-dash, not an en-dash.


Chris