ToDo

On any page which needs attention before it is ready for the manual, insert a link to this page by adding:

<div class="editornote">[[ToDo]] explanation of what needs to be done </div>

to that page. Be clear about the changes that are needed. Then anyone who visits this ToDo page can click on 'What Links Here' in the left sidebar to get a list of all pages with work to do comments.

Decisions

• We're not documenting all effects or all analyze menu items on a page-of their own. Only the most complex ones that require a screenshot will get that treatment. We don't have the time to do them all.
• Most effects and most analyze menu items will appear on the relevant page about that menu.
• The reference section should avoid tutorial exposition. It's kept brief, and links to tutorial sections as needed. (Should be viewed intelligently, so as to avoid shunting users around too much, and avoiding creation of half-page "tutorials" for the sake of it which is a significant reason for our duplication problem).

Sub-projects

Here are some specific ToDo projects...

• Keyboard Shortcut Reference looks a major task, inserting all the current shortcuts, categorizing and explaining them, and making it look decent.
• Rulers needs description of vertical rulers (or link to Zooming?).
• Complex effects Compressor, Equalization ask Martin for help here?, Noise Removal also link to text on wiki about the algorithm used??
• Index?? Let's get the talk page for it and discuss what we want.

• Images needed: Tool Bars needs an image of docking with a blue triangle. Edit Toolbar - I plan to upload backgroundless images.
• Image updates: Pencil image on Tools Toolbar needs white background.
• License information about LAME (from other wiki?), how to get hold of it.
• Audio CDs need to get text from other wiki and rejig??
• Different modes for the tracks, (spectrum, db, waveform)

Some details

• No info yet on using the Draw tool (linked to from Tools Toolbar)
• Decide on whether to keep old text on Tools Toolbar
• Decide on whether to keep old text on Control Toolbar
• Old text on Mixer Toolbar probably needs more reworking.
• Audio Files Preferences needs text for "Show Metadata Editor". We'll also need to rename this page to Import/Export Preferences
• All other Preferences images need updating as the tab order has changed.

Low Priority

• Technical info: nice to have... cepstrum (on plot spectrum), what an FFT is, why dB use logs, 'why you get clicks' when you remove sound.

The html manual distributed with Audacity is primarily the reference section. Tutorials and so on are nice to have with it, but are not essential. These sub-projects are therefore of lower priority.

• Tutorial - Your First Recording has screenshots of many types of connectors. Some text to explain what the differences are and how they are used would be nice, possibly a new page. There is some text already on the main Audacity wiki about this - we want to avoid duplicated effort, so we need to decide whether such text lives there or here.
• There are tutorials linked to from the Old Pages page, which are in an old style. They're not linked to from the Main Page. We need to decide which of these are already sufficiently covered by Dominic's new tutorials, and which need updating.
• Do we want to add an 'effects' section on the Main Page? I don't think we'll document all the effects and their parameters in time for 1.4.0. Should we even try to have some? NB: Potentially we could generate screenshots of all effects and their parameters automatically, but not in the 1.4.0 timescale.