Main Page

From Audacity Development Manual
Revision as of 21:09, 25 December 2007 by Windinthew (talk | contribs) (Comments on structure again)
Jump to: navigation, search

Welcome, Audacity manual editors!

This is both the front page of the online manual, and the road map for the printed manual. The printed manual is assembled by concatenating all of the articles found on this page, in this order. Anything which is not directly linked from this page will not go in the printed manual.

Links to another page, like [[File Menu]], become page references in the PDF, e.g. File Menu (Page 73).

External hyperlinks, like [http://example.com Example Website], appear in the text as Example Website1 with a footnote containing the URL.

Please read Editing Help to learn about wiki text formatting.

To update the PDF file, see the Export page.

We should try to be consistent in terms of wording and page layout. Layout issues for some page families are still being discussed. See Consistency for current suggested guidelines.

Images: Please ensure all images have appropriate ALT-text. This should be something that describes the contents of the image in the context of its surrounding text for someone who cannot see it.


Audacity Logo


This manual is a work in progress. It relates to the Beta 1.3.5 program, not 1.2.5/6! Audacity 1.3.5 is the basis for our upcoming 1.4.0 stable release of Audacity.

If you would like a Wiki account so that you can help us to complete it, e-mail James (James_AT_audacityteam_DOT_org)


For ideas on what needs to be done to move the manual forward, see:

essential changes to "Audacity for the Impatient" and essential changes to other Manual pages. Also visit the ToDo page.


None of these 'Download The Manual' links yet work properly. For now use this wiki. We'll get these other links working later.

Download the manual as a zip file

Alternate: Download the manual as a PDF file

Alternate: Download the manual as an RTF file (works great in Microsoft Word)

I've given the zip the most prominence, since this is what most people will need to access help from within Audacity.


Audacity 1.3.5 User Manual

Printed Manual Only

The following links will not be visible to users browsing the manual online.

Online Manual Only

The following links will not be included in the printed manual. You can do this with any text by wrapping it in <div class="noexport"> html tags.

Tutorials


This manual has two main parts to it:

  • A step by step guide. Organised by tasks (the Tutorials and the Using Audacity sections).
  • A reference section. Organised by GUI structure.

The reference section should be naming the parts of the GUI and saying in outline what they do.

Follow links from Special:Lonelypages and Old Pages to find remnants of the old manual.

The reference section needs to be complete for 1.4.0. I think it's OK if we don't finish all the tutorials, and drop the ones which are incomplete from the html help. JC

Using Audacity

Foundations

Modifying Audio

Perhaps Undo, Redo, and History (two commas is ungrammatical??) and Importing and Exporting belong more in "Foundations"? Learning how to use those is part of the overall process of editing but not in themselves about modifying audio.

I am still not 100% comfortable with this rather arbitrary distinction between "reference" and these "explanatory" articles which are not really full tutorials either (those should cover a wider process). Do we want both a non-tutorial Editing: Cut, Paste, and More and a tutorial on Editing? Should the former not be merged into File Menu now we have the principle of quick text? I know there are lots of images but we just put a load of images in Analyze Menu. Why is "Smooth Volume Changes...'" a section on its own when say "Moving tracks and clips with Time Shift Tool" isn't? Because of the length? Logically, that is not a very good justification IMO.

I would have a "Foundations" section and "Other Features" or similar for things that are specific yet wider than (so don't logically relate to) a Reference page . Everything else is a link-out from a Reference page in an appropriate place e.g. "Applying Effects" is under Effects in the Reference. Splitting Stereo Tracks is under Tracks. And even then, *only* if they cannot be conveniently merged into the detailed text in the reference page. - Gale
Suggest we change Smooth Volume Changes with the Envelope Tool to 'Volume Envelopes' ??
Title is not ideal but changing it is a lot of work- the sort of thing someone like Suf should do. See comments above also - Gale


Other Features of Audacity

Wanted Topics

Suggest we don't start writing these yet. Only topics in the reference section are must-haves for release. The Wanted Topics are in a 'noexport' section.

Disagree somewhat about the relegation (or presence) of some of these.

  • Recovery is a must and there should be advice on what to do if recovery fails (given it really isn't 100% reliable).
  • What can we say about editing samples not said in Draw Tool?
  • Cross Platform - what's this about? Is it more than Sending work to others?
  • Accessibility - Should include the JAWS guide (ready now). Shortcuts must be described (a major job, or are you suggesting not doing that for release?). We can write a short paragraph linking to Audacity Tracks and Clips, the Selection Bar etc. What else is needed that should hold this up in your opinion? - Thanks, Gale


Reference

Menu Bar:

Toolbars:

Project Window:

Preferences:

File Formats

Other

Need help? Visit http://audacityteam.org/forum - please do not email or post personal information as it will be displayed publicly. Many tips, tricks and useful articles can also be found on our user-editable Wiki - http://audacityteam.org/wiki/index.php?title=Audacity_Wiki_Home_Page

Unless otherwise noted, all pages on this site are available under the terms of the Creative Commons Attribution 3.0 license.

Retrieved from "http://alphamanual.audacityteam.org/m/index.php?title=Main_Page&oldid=3443"