[Jsonar] Revision History in the Readme
Yamuna Jivana dasa
ykhandoo at webmail.co.za
Sat Feb 14 06:40:47 PST 2009
Hi Vic,
My feeling on it is that as long as the readme has been updated to include
any keystrokes changes, new functions, Etc, then the revision history
wouldn't matter much.
For example, when we change the Control Numpad Slash to bring up the
right-click full blown context menu to the Control Applications key, that
new keystroke needs to be reflected in the help and readme.
We don't need to see the details. Just the information be updated. Anyone
who, let's say, gets confused about new functions or changed keystrokes or
whatever, can simply refer to the help or readme, which really needs to be
updated.
Anyway that's my take on it.
Alternatively if we are seriously going to stick with revision history,
which as I say I don't think is necessary provided that every change is
reflected in documentation and help, then you should find out if all those
people who do translations will really be happy to translate everything. If
not just keep the revision history in English.
So there's my thinking on the matter. <smile>
Yamuna
----- Original Message -----
From: "Chris Belle" <cb1963 at sbcglobal.net>
To: "JSonar -- JAWS Scripts for Sonar list" <jsonar at jsonar.org>
Sent: Saturday, February 14, 2009 10:44 AM
Subject: Re: [Jsonar] Revision History in the Readme
> Vic, don't be afraid to set realistic limits on your efforts.
>
> If people want more, let them step up to the plate, or break out the
> paypal, keeping one language up to date is hard enough, I'd rather
> see you code and fix new stuf rather than get bogged down in this
> kind of stuff.
>
> The shortest readme that has the relevant info, keystrokes, setup
> info, etc is what i like.
>
>
>
> At 02:06 AM 2/14/2009, you wrote:
>>Hello all,
>>Quick question for you: do you care if "Revision History" section
>>stays in the Readme or you never read it?
>>The reason I am asking is because it becomes less and less
>>convenient to maintain this section, especially now that JSonar is
>>being translated into several languages.
>>
>>Please reply to me either privately or to the list.
>>Thanks all,
>>Victor
>>
>>--
>>--- --- --- ---
>>Get a sneak preview of my album at:
>>www.victortsaran.com
>>--- --- --- ---
>>
>>_______________________________________________
>>Find JSonar and Sonar FAQs, articles, guides and downloads at jsonar.org.
>>
>>Jsonar mailing list
>>Jsonar at jsonar.org
>>http://jsonar.org/mailman/listinfo/jsonar_jsonar.org
>>
>>
>>No virus found in this incoming message.
>>Checked by AVG - www.avg.com
>>Version: 8.0.237 / Virus Database: 270.10.23/1952 - Release Date:
>>02/13/09 18:29:00
>
>
> _______________________________________________
> Find JSonar and Sonar FAQs, articles, guides and downloads at jsonar.org.
>
> Jsonar mailing list
> Jsonar at jsonar.org
> http://jsonar.org/mailman/listinfo/jsonar_jsonar.org
>
--------------------------------------------------------------------------------
No virus found in this incoming message.
Checked by AVG - www.avg.com
Version: 8.0.237 / Virus Database: 270.10.23/1950 - Release Date: 02/12/09
18:46:00
More information about the Jsonar
mailing list