Difference between revisions of "Wording"

From Audacity Wiki
Jump to: navigation, search
(Move done items and tidy.)
(few minor tidies and clarifications)
Line 10: Line 10:
 
=Outside the program itself=
 
=Outside the program itself=
  
* [RA] Update the  
+
This is for any documents included in source code but not part of the program wording. See [[Documentation Checklist]] for all other documentation requirements including issues that must be release noted if not fixed.
{{external|1=[http://audacity.cvs.sourceforge.net/audacity/audacity-src/help/audacity.1?revision=1.4.2.1&view=markup Unix manual page]}} to distinguish between 1.3 and 1.2. In particular, remove reference to 1.3 importing multiple files from command line into the same Project, unless fixed before release (See [[Release Checklist#Aim to|Aim to]] for details).    
+
* Release note for loss of second imported track in Project after crash or loss of entire Project if second track is edited.  Unless this is fixed before release.
+
* [RA] Update the {{external|1=[http://audacity.cvs.sourceforge.net/audacity/audacity-src/help/audacity.1?revision=1.4.2.1&view=markup Unix manual page]}} to distinguish between 1.3 and 1.2. In particular, remove reference to 1.3 importing multiple files from command line into the same Project, unless this ability is reinstated before release (See [[Release Checklist#Aim to|Aim to]] for details).  
 +
 
  
 
= Preferences =
 
= Preferences =
Line 32: Line 33:
 
'''Current Text:'''
 
'''Current Text:'''
  
"When importing audio, normalize all tracks" (n.b. doesn't really belong on batch tab)
+
"When importing audio, normalize all tracks" (n.b. doesn't really belong on batch tab and should be moved to File Formats tab and that tab renamed more appropriately -see below).
  
 
What this option does is to normalise any imported track to the current normalise level set at Effect > Normalize (whether or not done as part of a batch process) and additionally, normalise any other audio tracks already on screen. It doesn't normalise audio tracks on screen when you apply a chain to the current project, which it's possible users might have interpreted it as doing.
 
What this option does is to normalise any imported track to the current normalise level set at Effect > Normalize (whether or not done as part of a batch process) and additionally, normalise any other audio tracks already on screen. It doesn't normalise audio tracks on screen when you apply a chain to the current project, which it's possible users might have interpreted it as doing.
  
<font color="green">GA has slight reservation on the current wording that it may be unclear to a user who is only thinking of importing into an empty project. As we will have space, and to be consistent with the other text on the file tab:</font>
 
  
 
'''Suggested replacement:'''
 
'''Suggested replacement:'''
  
"When importing audio files, normalize all tracks in project" (and move this to renamed file tab)
+
"When importing audio files, normalize all tracks in project"  
  
This option should move into the "File Formats" tab after that tab has been renamed, see [[Wording#File_Formats_tab|File Formats tab]] for more.  The items in this tab have more space for text, so a longer more explanatory string is possible.  Also consider a change after 1.4 so that only one normalisation is done where you have a chain starting with that effect and "normalize" is turned on (this has been placed in "not aiming").  
+
<font color="green">GA suggests this revised wording clarifies to a user who may be thinking only about importing into an empty project. This wording would be consistent with the other text on the current File Formats tab and we have space for it there.  
  
<font color="green">GA believes these are good moves and that "normalize all tracks" will be used when it is in an appropriate tab and clearer what it does.
+
Then move this option into the "File Formats" tab after that tab has been renamed, see [[Wording#File_Formats_tab|File Formats tab]] for more. Also consider a change after 1.4 so that only one normalisation is done where you have a chain starting with that effect and "normalize" is turned on (this has been placed in "not aiming"). GA believes these are good moves and that "normalize all tracks" will be used when it is in an appropriate tab and clearer what it does.
 
+
</font>
I suggest this would look best as the first option in the file tab. </font>
 
  
 
----
 
----
Line 74: Line 73:
 
==File Formats tab==
 
==File Formats tab==
  
'''Problem with Tab name:'''  
+
'''Problem with tab name:'''  
  
 
Since the exporting options for formats were removed from here, the tab description is no longer clear as to what it contains, and suggests it contains what it does not.
 
Since the exporting options for formats were removed from here, the tab description is no longer clear as to what it contains, and suggests it contains what it does not.
Line 88: Line 87:
 
In any of these three cases I have these additional suggestions:
 
In any of these three cases I have these additional suggestions:
  
'''New text, moved in from Batch tab:'''
+
'''New text, at top of this tab and moved in from Batch tab:'''
 +
 
 +
"When importing audio files, normalize all tracks in project"
  
"When importing audio, normalize all tracks"
+
See discussion of wording of this item in [[Wording#Batch tab|Batch tab section]]. 
  
See explanation in batch tab section. 
 
  
 
'''Current text:'''
 
'''Current text:'''

Revision as of 18:04, 21 October 2007




Outside the program itself

This is for any documents included in source code but not part of the program wording. See Documentation Checklist for all other documentation requirements including issues that must be release noted if not fixed.

  • [RA] Update the Unix manual page  to distinguish between 1.3 and 1.2. In particular, remove reference to 1.3 importing multiple files from command line into the same Project, unless this ability is reinstated before release (See Aim to for details).


Preferences

Audio I/O tab

Latency panel:

Ideally this needs a few helpful words, but there is little space. Is it essential we keep the panels of equal height? If it is, then how about adding after "milliseconds":

Audio to buffer: - "higher = more latency"

Latency correction: - "negative = backwards"

If we can make more space, then we could elaborate: "higher value = more latency but more reliable recording" ; "Applies when playing tracks whilst recording. Negative value shifts recording backwards." Of course this is a substitute until we have context-sensitive help. - GA

Batch tab

Current Text:

"When importing audio, normalize all tracks" (n.b. doesn't really belong on batch tab and should be moved to File Formats tab and that tab renamed more appropriately -see below).

What this option does is to normalise any imported track to the current normalise level set at Effect > Normalize (whether or not done as part of a batch process) and additionally, normalise any other audio tracks already on screen. It doesn't normalise audio tracks on screen when you apply a chain to the current project, which it's possible users might have interpreted it as doing.


Suggested replacement:

"When importing audio files, normalize all tracks in project"

GA suggests this revised wording clarifies to a user who may be thinking only about importing into an empty project. This wording would be consistent with the other text on the current File Formats tab and we have space for it there.

Then move this option into the "File Formats" tab after that tab has been renamed, see File Formats tab for more. Also consider a change after 1.4 so that only one normalisation is done where you have a chain starting with that effect and "normalize" is turned on (this has been placed in "not aiming"). GA believes these are good moves and that "normalize all tracks" will be used when it is in an appropriate tab and clearer what it does.


Current text:

"Show MP3-ID3 Dialog"

The dialogue now appears for all valid formats (FLAC, WAV etc.), so...

Suggested replacement:

"Show Metadata Editor prior to export step"


Directories tab

Current text:

"Auto save every [ ] minutes"

Suggested replacement:

None if [MM] changes autosave to strict interval saving as per aim-to. Wording needs changing if strict interval saving not implemented. Suggested would be "Auto Save interval" (fudge).


File Formats tab

Problem with tab name:

Since the exporting options for formats were removed from here, the tab description is no longer clear as to what it contains, and suggests it contains what it does not.

Suggested replacement:

GA: No solution is ideal due to the disparate nature of what's in there. "Export & Import" is one possibility except that does not really cover the dependencies option. I have three renaming suggestions:

  1. "File Behaviors" or
  2. "Audio Files"
  3. "Files"

In any of these three cases I have these additional suggestions:

New text, at top of this tab and moved in from Batch tab:

"When importing audio files, normalize all tracks in project"

See discussion of wording of this item in Batch tab section.


Current text:

"When importing uncompressed audio files into Audacity"

Suggested replacement:

"When importing uncompressed audio files"

Yes - JC, GA.


Current wording and order:

"When saving a project that depends on other audio files"

[*] Ask user

  • Always copy all audio (safest)
  • Never copy any audio

Suggested change:

  • Always copy all audio into project (safest)
  • Do not copy any audio

[*] Ask user

GA thinks this does not read well with "Ask user" at top - you have to look further down to see what you are being asked. This change will also match the "importing" option by having the safe option at the top. "Do not copy any audio" is the new standard button text. It may not be better here than "Never copy any audio", but I think it's worth asking.


Current text:

"When exporting tracks"

Suggested change:

"When exporting tracks to an audio file"

Just re-emphasizes saving/export distinction but am prepared for it to be considered verbiage.

Current Text:

"MP3 Export Setup"

Especially with the proposed renaming of this tab, I think this should be moved into Directories tab and renamed to:

Suggested change:

"MP3 Export Library Location"

which is what it actually is.


Suggested additional text:

Significant numbers of users have reported difficulty finding the new location of file format export options. Whilst "when exporting tracks" needs to remain here instead of in the Export File dialogue where it should be, I suggest adding text explaining where the export options have gone to. I suggest this could go inside the "when exporting tracks" panel under the radio buttons, and say:

"Note: Export quality options for WAV, AIFF, MP3 and other formats can be chosen by clicking the Options button at time of export."


Interface tab

Behaviours:

Current text:

"Dragging of left and right selection edges"

Suggested replacement:

"Enable dragging of left and right selection edges"

Current text:

"Present track number to accessibility aid"

Suggested replacement:

"Present track number as accessibility aid"

Is this a screen reader function, not anything that appears visually? Or what does this do and is there a better description we can make? - GA


Done

  • Normalize on Load changed to When importing audio, normalize all tracks.

  • Innertext:Recording written and text on monitoring added

  • Innertext:Export written and three typos corrected.

  • Innertext:Editing written and title changed to 'Editing and Greyed out Menus'.

  • Save Changes? Dialogue with empty Project: changed from "\n\nSaved project will be empty!!\n\nTo save the tracks you previously\nhad, click cancel, restore the tracks\nusing undo, and then save." to "\n\nSaved project will be empty!!\n\nTo save the tracks that were previously\nopen, click Cancel, Edit > Undo until all your\ntracks are open, then File > Save Project."

  • Interface tab, Show/Hide: "Show Welcome Message at program start up" , was 'Splash Screen'.

  • Find Clipping: "Start and stop must be greater than 0", was 'positive and greater than zero'.

  • Dependencies dialogue: The former "Close" and "Skip" buttons now both read "Do not copy any audio".

  • Export Multiple progress dialogue: "Exporting the entire project as a WAV/AIFF file" or (for MP3) "exporting the entire file..." now changed to "Exporting entire project" with (filename) in the dialogue title and (format) above the progress bar.

  • Latency Shift Dialogue: In "I have brought it back to start at zero", "I have" has been replaced with "Audacity has".

  • Preferences: Interface tab: "Tracks &fit vertically zoomed" changed to "Automatically &fit tracks vertically zoomed"

  • "Audacious!" buttons -> "OK... Audacious!"

  • GUIPrefs.CPP:

- "&Select all audio, if none selected, on applying effect"

+ "&Select all audio in project, if none selected"

- "&Circular track keyboard navigation"

+ "\"Move track focus\" &cycles repeatedly through tracks"

- "&Quit Audacity upon closing last window"

+ "Any Close/Exit command completely &quits Audacity"


  • Import.CPP:

- " is an encrypted audio file, typically from an online music store. \nAudacity cannot open this type of file due to the encryption.\nYou need to convert it to a supported, unencrypted audio format."

+ " is an encrypted audio file. These typically are from an online music store. \nAudacity cannot open this type of file due to the encryption. \nTry recording the file into Audacity, or burn it to audio CD then \nextract the CD track to a supported audio format such as WAV or AIFF."

- " is an audio CD file. \nAudacity does not open this type of file.\nTry ripping it to a native audio format that Audacity can import."

+ " is an audio CD track. \nAudacity cannot open audio CDs directly. \nExtract (rip) the CD tracks to an audio format that \nAudacity can import, such as WAV or AIFF.");

Add "WAV or AIFF" references to Real, AAC and WMA:

- " is a RealPlayer media file. \nAudacity cannot open this..."

+ " is a RealPlayer media file. \nAudacity cannot open this proprietary format. \nYou need to convert it to a supported audio format, such as WAV or AIFF."

- " is an Advanced Audio Coding file. \nAudacity cannot open this..."

+ " is an Advanced Audio Coding file. \nAudacity cannot open this type of file. \nYou need to convert it to a supported audio format, such as WAV or AIFF."

- " is a Windows Media Audio file. \nAudacity cannot open this..."

+ " is a Windows Media Audio file. \nAudacity cannot open this type of file due to patent restrictions. \nYou need to convert it to a supported audio format, such as WAV or AIFF."



  • Default temporary directory: changed from "/tmp/audacity1.2-%USERNAME" to AUDACITY_VERSION, AUDACITY_RELEASE string