Difference between revisions of "Talk:Wording"

From Audacity Wiki
Jump to: navigation, search
(open file dialog title)
(more on ellipses)
Line 86: Line 86:
 
***'''Ed:''' I just checked with Steve, the Nyquist guru, and he said: "[code];action "wave-shaping peaks..."[/code]is the message that is shown while the plug-in is processing.". So, if the built-in effects' string is standardized I suppose the shipped Nyquist ones should also conform.
 
***'''Ed:''' I just checked with Steve, the Nyquist guru, and he said: "[code];action "wave-shaping peaks..."[/code]is the message that is shown while the plug-in is processing.". So, if the built-in effects' string is standardized I suppose the shipped Nyquist ones should also conform.
 
**@Gale--to what were you disagreeing--my solutions, the MSDN standards or both?
 
**@Gale--to what were you disagreeing--my solutions, the MSDN standards or both?
 +
**After reading a bunch of style guides and the MSDN guide on using the ellipsis I think I have changed my position. Here is the interactive dialog which is the result of the menu item (which menu item rightly has the ellipsis):<br>
 +
[[image:Interactive.png]]<br>
 +
 +
Here is the current progress dialog:<br>
 +
[[image:Ellipses.png‎]]<br>
 +
I fell that the title of the progress dialog should not have an ellipsis (as the interactive dialog does not). I also feel that the message in the progress dialog should have the ellipsis (which it does not).
  
 
==Rules for our Text==
 
==Rules for our Text==

Revision as of 22:28, 11 November 2011

If it proves difficult to decide between different alternatives to wording, then we may need to have some kind of voting. I'm not keen on that as it adds overhead and takes longer to sort out. Probably a better scheme is to assume that we will easily reach consensus in most cases, and just flag the difficult cases if they arise. James 13:59, 7 October 2007 (PDT)


Old discussions should probably be removed from the main page in time, and archived here, and later removed altogether. That's not the 'done' items, rather it's the items for which we decide wording after some discussion.


distinction between Open Project & Import audio file

initial report by Ed Nov 2011 If Audacity keeps the distinction between "Open Project" and "Import audio file" the Open File Dialog might have two different potential titles. Currently, "_("Select one or more audio files...")" is used for both (and as it is the Dialog title probably should not have a trailing ellipsis--see MS Word's Open Dialog which does not). Proposed:

  • If current distinction between Open & Import persists:
    • Open Project: "_("Open one or more Audacity Projects")"
    • Import audio: "_("Import one or more audio files")"
  • otherwise:
    • "_("Open")"

Note that when File > Import > Labels... is chosen its Dialog title is distinct: "Select a text file containing labels..." (but again contains a spurious ellipsis). Similarly, Import MIDI and Raw both have distinct titles. In the MIDI case, it says "Select a MIDI file..." in which the "a" properly implies you may only Import one MIDI file via the dialog. However, in the Raw case it says "Select any uncompressed audio file..." which is slightly ambiguous--maybe "any" should be "a".


spurious ellipsis

initial report by Ed Nov 2011 patch

Inspecting the header files in src/effects we find the effects classes each of which has a function GetEffectAction() which returns a brief description of what the effect "does". Most have a well formed text but a few have a spurious ellipsis at the end. I propose removing the ellipse.

Additionally, almost every string is in title case (Every Word Capitalized Except the, for and to), so made the two or three exceptions comform.

This one is good:

class EffectWahwah:public EffectSimpleMono { [...]

  virtual wxString GetEffectAction() {
     return wxString(_("Applying Wahwah"));

These all have a spurious ellipsis:

class EffectTruncSilence: public Effect { […]

  virtual wxString GetEffectAction() {
     return wxString(_("Truncating Silence..."));

class EffectSpikeCleaner: public EffectSimpleMono { […]

  virtual wxString GetEffectAction() {
     return wxString(_("Applying Spike Cleaner..."));

class EffectNormalize: public Effect […]

  virtual wxString GetEffectAction() {
     return wxString(_("Normalizing..."));

class EffectLeveller: public EffectSimpleMono […]

  virtual wxString GetEffectAction() {
     return wxString(_("Applying Leveller..."));

class EffectCompressor: public EffectTwoPassSimpleMono { […]

  virtual wxString GetEffectAction() {
     return wxString(_("Applying Dynamic Range Compression..."));

class EffectClickRemoval: public Effect { […]

  virtual wxString GetEffectAction() {
        return wxString(_("Removing clicks and pops..."));

class EffectChangeLength: public Effect { […]

  virtual wxString GetEffectAction() {
     return wxString(_("Changing Length..."));

class EffectAutoDuck: public Effect […]

  virtual wxString GetEffectAction()
  {
     return wxString(_("Processing Auto Duck..."));


    I believe the shipped Nyquist effects are correct as per the above bullet points so would all have to be changed if your patch was applied... (ellipses intentional).
  • Ed 11/11/11:
    • Do we have a mechanism for creating a "standard" for this? Maybe just a comment in the source, but I do not see where to put it so that it will be seen.
    • In the above built-in effects, the point is that a majority (generally "most") have no ellipsis in the string returned by GetEffectAction(). Either way, they all should be the same and, as it it is description not a title nor label, I agreed with the majority to not have an ellipsis.
    • As for the title case in the description, I would cap the effect title, the first word, no other words and make them all full sentences with a period/full stop at the end; in the above cases I just made the 2-3 which were odd-effect-out match the current style.
    • As for the shipped Nyquist effects, if they have a GetEffectAction() method which returns a string, I believe they should conform to the same standard (once one is made and enforced).
      • Ed: I just checked with Steve, the Nyquist guru, and he said: "[code];action "wave-shaping peaks..."[/code]is the message that is shown while the plug-in is processing.". So, if the built-in effects' string is standardized I suppose the shipped Nyquist ones should also conform.
    • @Gale--to what were you disagreeing--my solutions, the MSDN standards or both?
    • After reading a bunch of style guides and the MSDN guide on using the ellipsis I think I have changed my position. Here is the interactive dialog which is the result of the menu item (which menu item rightly has the ellipsis):

Interactive.png

Here is the current progress dialog:
Ellipses.png
I fell that the title of the progress dialog should not have an ellipsis (as the interactive dialog does not). I also feel that the message in the progress dialog should have the ellipsis (which it does not).

Rules for our Text

Do we have any consistent rules about text? For example, we always capitalise 'Audacity'.

Do we capitalise, single quote or double quote menu item names when used in text?

Capitalise and double quote e.g. "Effect" Menu? [GA]

Do we use '->' or '>' when describing menu/submenu sequences?

'>' (without the quotes) ? [GA]

Do we have an upper limit on how much text we will put on a button or on a radio button?

Does it depend on the dialogue in question to some extent? [GA]

Old Discussions