Plan for P1/P2 clean-up

Permanent P1's

• Perform a link check using Xenu or other software.

• Check at Code Review 2.1.0 that there are no commits listed in "Not assessed" and that Status reads per the latest commit at https://code.google.com/p/audacity/source/list.

• Change the version number on the front of the Manual from "Audacity 2.x.x-alpha Development Manual" to "Audacity 2.x.x Manual" (whatever the current release is).

• Change the version number of the Manual at Unzipping the Manual in the "x"'s as below:
  • http://sourceforge.net/projects/audacity/files/audacity/2.x.x/audacity-manual-2.x.x.zip/download
    • Gale 25Dec14: The link on Unzipping the Manual has been set to the agreed 2.1.0 version.

After release

• Log in to https://www.virustotal.com/en/, upload the new Windows EXE file and scan it. On the results page, add a comment in the form

#audacity x.x.x for Windows (EXE)

where x.x.x is the release number. This scan result can then be found by users following the instructions on http://manual.audacityteam.org/o/man/faq_about_audacity.html#spyware to locate Audacity scan results.

• Change all version numbers on the front page of the Manual as in the "x" as below. Typically, this would increment just the third number by 1:
  • Audacity 2.x.x-alpha Development Manual.
  • This online Manual is only for the latest 2.x.x-alpha development code. The online Manual for the current 2.x.x release is here. Click here for legacy 1.2 documentation.
  • Use Help > Manual (in browser) in the current 2.x.x release to access an installed copy of the Manual.
  • You can download and install the 2.x.x Manual if the Manual is not installed.

P1

• Main Page the imagemap will require updating for the toolbars that have changed in 2.1.0: Meters, Device, Mixer - the tooldock layout has changed too.
  • Peter 29Jan15: this is normally Bill's bailiwick, I'm assuming he has this in hand. Cannot really be worked on until the GUI is frozen.
• Effect Menu: FXB needs documenting
  • Peter 29Jan15: Neither Bill nor I know anything about the technicalities of this.
• Edit Menu: Select sub-menu omits new spectral selection commands.
• Transport Toolbar: needs the new "Append Record" icon and the new "Play Cut Preview" icon documenting.
  • Peter 29Jan15: I have no idea how to create these naked button images
• Effects Preferences: Ongoing discussion Bill/Gale on whether "Register Plugins dialog" belongs here. Plus new image needed.
• Spectral Selection: in the "Spectral Editing" section Gale comments "more explanation of the technicalities will be needed, especially what a shelf filter is and what rolloff is."
• Real-time preview of effects: We need a new image of the "control panel" of a VST effect in graphical mode. We may also want an example of a LADSPA effect in text mode

Noise Reduction/Removal P1 in the Wiki

The following Wiki pages will also need attention regarding the new Noise Reduction but the final work can only be undertaken once 2.1.0 is released - as the Wiki always relates to the current version. The preparatory groundwork has been laid to prepare for this task.

• New page Noise Reduction created - but it needs some serious editing
• Old page Noise Removal must remain in Wiki until 2.1.0 is released, then it can become a landing page
• New page How Noise Reduction Works created - but it needs some serious editing
  • Peter 29Aug14: Done: Paul Licameli has edited the page to bring it up to date with the new technology
• Old page How Noise Removal Works must remain in Wiki until 2.1.0 is released, then it can become a landing page
• and probably Proposal Noise Removal

New Hosts

Not yet listed as P1s, as there remains the issue of whether or not:

• WASAPI full functionality retained - or reversion to loopback only

WDM-KS is turned off for 2.1.0

The following pages currently have P2s associated with WDM-KS / WASAPI that may become P1s:

• Glossary
• Device Toolbar
• Devices Preferences
• Tutorial - Selecting Your Recording Device
• Tutorial - Recording Computer Playback on Windows

Wiki P2s re WDM-KS

• Windows Vista OS
• MultichannelRecording
• Windows 7 OS

These above three P2s in the Wiki - all relate to WDM-KS

P2s that may block a release

• Mixing Audio Tracks: There is no mention here or in Tracks Menu of how render handles white space before the audio begins or audio before zero. Should there be? Current behaviour following r11248 is to preserve the clip length by no longer rendering white space between time zero and first audio as silence, and to preserve audio before time zero instead of discarding it. So people who want to export tracks with silent lead-ins preserved now have to generate silence after rendering. I think that tip at least should be in this page.
• Audio Track Dropdown Menu: accuracy comment from Steve - needs checking
• DC offset: need to discuss naturally occurring offset recordings
  • Peter 29Jan15This has been an ongoing unresolved ednote discussion since late 2012

Placeholders for Modules

Modules has been turned off for 2.1.0

• Preferences Add Modules Preferences to the list of Prefs. Replace all the images (Modules Prefs image already replaced)
  • Peter 06Oct14: Has Modules Prefs been fully turned on - or is it just loaded as "experimental" for testing? I.e. how likely is it to remain a feature for 2.0.7 release?
  • Gale 07Oct14: It has been defined in Experimental.h so if that does not change it will be released.
    • Peter 07Oct14: In which case I am inclined to leave working on this until later in the release cycle (as I do not want to have to unpick all this yet again if we decide not to retain it). As it is, when I unwound it last time I left copies on the various Prefs pages of the necessary stuff for the imagemaps (saved on the Talk pages) and we can easily revert to the prior images. Thoughts?
    • Gale 08Oct14: Thanks for saving the image map data. I think we can leave this for the immediate future, as you suggest.
  • Peter 13Jan15: It's looking like, if I read Vaughan's RM email comments correctly, that Modules will not be in 2.1.0.
• Modules Preferences Update the page.
  • Peter 06Oct14: I was going to start work on this - but when I go to the Prefs>Modules page all I get is the dialog box with "No modules were found" available in the dropdown list. Is that it?
  • Gale 07Oct14: Most users will not have any modules, so that is how the topmost image in the Modules Prefs page should appear in the Manual (except we are waiting for James to add text about the need to restart). Users who install current Audacity over previous versions where mod-script-pipe was shipped will see mod-script-pipe in Modules Prefs as "New", so that case ought to be documented. Note that if they "enable" that old mod-script-pipe in Modules Prefs, Audacity won't launch any longer, which will have to be fixed.

    The meaning of each choice in Modules Prefs will have to be documented so only someone who can build a module the same day as building Audacity can fully document it. So either Steve or I will have to document this page.

  • Peter 13Jan15: It's looking like, if I read Vaughan's RM email comments correctly, that Modules will not be in 2.1.0.
• Nyquist Prompt: An experimental "Nyquist Workbench" graphical editor module is available if you compile the module and Audacity from source code, then enable the module in Modules Preferences.
  • Peter 13Jan15: It's looking like, if I read Vaughan's RM email comments correctly, that Modules will not be in 2.1.0.

P2 placeholders for VST Linux support when re-enabled

• In Effect Menu and FAQ:Installation_and_Plug-Ins

P2 placeholders for VST presets Mac bug

• In Effect Menu#vst_presets - for removal of Mac-only advice if file extension bug is fixed

P2 placeholder for Audacity compilation on Linux against FFmpeg

• Gale 10Sep14: FAQ:Installation_and_Plug-Ins#FFmpeg version support - Placeholder P2 to change the text about dynamic loading if bug 540 is fixed and to monitor compiling status on different distros.

Items completed subject to review

• Noise Reduction much editing is still required

Placeholders

• FAQ:Recording - Troubleshooting#pauses: This probably wants "pausing" split into a separate FAQ and the formatting improved.

• Regular Interval Labels Gale 14Oct14: Monitor Bug 768 and remove the "currently necessary" sentence if the bug is fixed.

• Tracks Menu: Gale 12Aug13: There is a strong case for an examples page since some users shy away from the align commands as they are thought to be complex.

• Tutorial - Recording audio playing on the computer: maybe mention that audio can be ripped from DVDs with details
  • Gale: Probably needs a Wiki page first, in view of the complications. Been on my list for ages.

• Tutorial - Copy and paste a section of audio: Gale 15Apr13: wrote "This is orphaned and not as good as it could be. The best suggestion at the moment seems to be to tweak it and move it into Tutorial_-_Editing_an_Existing_File with a longer term intention of some Manual or more likely Wiki material on repairs including drop-ins. See http://forum.audacityteam.org/viewtopic.php?p=210332#p210332 for some other suggestions."
  • Peter 23Apr13: As an orphaned page this is clearly not a release-blocker.

• Transcription Toolbar: This is a placeholder P2 "Having to click the Play-at-Speed button to change speed was a change made to prevent a freeze on Linux with some buggy versions of PulseAudio. Previously, dragging the slider restarted playback. Please monitor this and change the Manual if the behaviour is changed back."
  • Peter 23Apr13: Not a release-blocker.

• Keyboard Shortcut Reference: When Bug 133 is fixed, remove "You need to then use the Play-at-speed shortcut above to restart playback at the new speed." from the "Increase/decrease playback speed" shortcuts.

• Splitting a recording into separate tracks: replace the references to the two Finders with Steve's new Album Track Marker when it gets released.
  • Peter 22Aug13: Moved to placeholder section as Album Track Marker will not be in 2.0.4/2.0.5/2.0.6 (as discussed with Steve).

• Sample workflow for LP digitization: If and when an improved Sound-Finder/Silence-Finder gets implemented consider adding advice about sound/silence finder as a way to place labels. Peter 19Jul13: Steve is currently working on a new Analyzer with a working title of Album Track Marker.
  • Peter 22Aug13: Moved to placeholder section as Album Track Marker will not be in 2.0.4/2.0.5/2.0.6 (as discussed with Steve).

Completed items

• Index of Effects, Generators and Analyzers table and lists: removed Cross Fade Out and added the three Spectral Edit effects.

• Gale: New images made for the Preview button added to Nyquist Prompt, clipfix, delay, highpass, lowpass, notch, tremolo, vocalremover and vocoder effects. Text changes made. Adjustable Fade does not have a Preview button because the effect changes over time and Preview only works on the preview length.

• RMS not rms, including Contrast image updated for "RMS".

• Device Toolbar, Mixer Toolbar and Meter Toolbar have recording before playback. New images needed, probably a number of images involved for Meter Toolbar, and text should be checked as well for instances of "right-hand" and "left-hand".

• Tutorial - Recording Computer Playback on Windows: Review WASAPI loopback changes - they may need expanding.

• Crossfade Tracks new effect needs documenting:
  • new Crossfade Tracks page added
  • Entry created for it in Effect Menu - removed entries for Cross Fade In/Out
  • Entry created for it in Index of Effects, Generators and Analyzers - removed entries for Cross Fade In/Out
  • Fade and Crossfade updated - - removed entries for Cross Fade In/Out
  • Creating a Crossfade updated
  • Fades updated - removed Cross Fade In/Out - added link to Crossfade Tracks
• Tutorial - Recording Computer Playback on Linux New images needed here (recording now before playback)

• The new Noise Reduction effect will be replacing Noise Removal in 2.1.0 and the Noise Removal effect will be "retired". This is looing like a fair amount of work. Pages affected:
  • Noise Removal page to be "retired" - care to be taken with links.
    • Content has been "retired" left a ghost landing page to redirect readers (from external links - mainly Forum) to the new page
  • Effect Menu requires updating
  • Index of Effects, Generators and Analyzers requires updating
  • Several other pages have links to Noise Removal that need to be changed to Noise Reduction - some of these have text that will need potential tweaking to reflect the removal=>reduction change.

• Meter Toolbar Transition band and Meter Preferences changes. Click the playback meter to reset the peak level indicator instead of having to click the record meter.
  • Peter 09Oct14: As Leland informed us that no further changes will be made for now I went ahead and added documentation for the new Gradient Meters.

• Digital Audio Fundamentals: "Sample rates" section needs editing - the whole page should be reviewed