User talk:PeterSampson/Outstanding P2s (To-Do-2s) in the manual

This page contains the list of completed/demoted items:

License
This requires someone to update it with the relevant text from the source code. I do not have the source code so cannot do this.

COMPLETED: No-one has picked this up as a task yet.
 * Gale 20Dec11: If I do it (given I added the P2) I would rename it as "Audacity License" - otherwise it's too confusing with the CC BY 3.0 licence of the Manual (and of any web page).
 * Bill 20Dec11: Fine by me. And what we're talking about here is the licences for all the libraries, Nyquist and Lisp that are listed in the README.txt file under "4. Source Code, Libraries and Additional Copyright Information"? The GPL2 section should not need changes, should it?
 * Gale 20Dec11: The GPL2 is verbatim and must not change. So OK I will attend to that.
 * Peter 27Dec11: Gale has updated this.

Tutorial - Recording Computer Playback on Windows
As no-one with a W7 background has reviewd this since I set the ToDo-2 for proofreading back in August I have now asked my wife (who is an experienced Vista and W7 user to have a look at this page.

COMPLETED: Mrs. S. has agreed to review this over the weekend and Gale has said he will review it too.
 * 'Peter 23Dec11: Proofread for spelling, grammar and accuracy by Mrs. Waxcylinder (a W7 user).

Tools Toolbar
Bill added a note a while back requesting that we add a note about “time shifting with Selection Bar or plug-in for (VI users)” He went on to comment that he “couldn’t get this to work. The selection bar will move the selection but not the clip”. This is beyond my skills and experience.

DOWNGRADED TO ToDo: Bill says that Gale knows how this works ...

Bill: See note at bottom about time shifting using the selection bar. Do we want to document that functionality here, or on the Selection Toolbar page? Gale: Definitely mention it here but link to the Time Shift section on Accessibility when written. Bill: Will wait until we have something to link to.
 * Steve 20Dec11: I know how to move ALL clips in a track using only the keyboard, but the only way that I can think of to move ONE clip if there are other clips on the track is to first Cut and Paste that clip to a new track. Is there another way?
 * Bill21Dec11 IIRC that note (as quoted above) was already on that page in Nov 2009 when I started working on it, and the original note was from Gale. I had some correspondence with Gale (which I now cannot find) in which he explained how it can be done. What I could find was this:

So perhaps, until that section in the Accessibility page gets written, we can demote this to Px?


 * Peter 22Dec11: +1 to Bill's suggestion to downgrade to Px - and  I suggest we add an editornote re. future linking to the Accessibility page when it gets written.
 * Bill 22 Dec11: Done - downgraded to Px and added link to Accessibility page with explanation.

View Menu
The ToDo-2 here is a request to document the “Undo Levels” and “Discard…” in View History … I have very limited experience of using this command so would prefer it if someone else could take a crack at this. I’m very happy to review and edit it though – and if no-one else wants to step up to the plate I will try to take a crack at it.

DONE: Bill comments that this needs quite a bit of work, including what kind of images are appropriate.

I propose that we consider demoting this to a ToDo so that it does not remain a blocker to a 2.0 RC. Anybody agree?
 * Bill 16Dec11: I think we need to do something with the images of the History window and Project window side by side. They are unreadable. Added comment to View Menu.


 * Bill 19Dec11: We have the Undo, Redo and History page - would it make sense to put the gory details there, with a link here to that page?
 * Peter:Yes, I agree with Bill: the Undo, Redo and History page is the right place to the full operational details (I never knew we had that page) and that includes the two images under discussion here (suitable revised) which should be moved to Undo, Redo and History - and of course a link there from this page. We always try to avoid duplication wherever possible and this is one place where can clearly do so.


 * Peter 19Dec11: there is a problem with the formatting on the View Menu page, starting in the History section Bolding gets turned permanently on for the rest of the page from within that section. I have created a fresh ToDo-2 for this. I have had a long look at this and can't find the problem - all the triple-quotes seem to be properly matched in pairs and there are no b /b pairs - so the syntax looks ok. I'm now at a loss to understand how to fix this. Any thoughts?
 * Steve 20Dec11: I don't see the problem. Have you tried refreshing your browsers cache of the page (Ctrl+F5 will probably do that).
 * Peter 20Dec11:I flushed my buffers and refreshed the page but I still get the same display problem - on both my PCs.
 * Peter 21Dec11: Fixed by Bill.


 * Peter 21Dec11: Now that Bill has beefed up the Undo, Redo and History page and provided a link to it from the View Menu page then I think we can clear the ToDo-2 (and remove the earlier unreadable images on Undo on the View Menu page - which ill has commented out in an editornote.
 * Bill 21Dec11: Obviously I'm OK with what's on that page, but I think others should review it. Removed ToDo-2 from View Menu as we seem to be agreed that the gory details should be on Undo, Redo and History. See new section below.
 * Peter 22Dec11: Can we now remove/delete the section in View Menu that Bill has commented out - the section with the old unworkable images? The meat of this is already noved to Undo, Redo and History.

Undo, Redo and History
DONE:
 * Bill 21Dec11: I've added a ToDo-2 to Undo, Redo and History to review what I've done there.
 * Peter 22Dec11: I've reviewed it - suggested moving the Undo v. Discard note div up in the section.
 * Peter 28Dec11: Bill responded with good reasons to retain the Discard not div at the bottom - I accept his reasoning here.

Audacity Tracks and Clips
This relates to the work which was started a few weeks back thinking about this page, the Audio Tracks page and Bill’s new proposed Splitting & Joining Tracks. We set this work aside in the interests of getting 1.3.14 out the door – we need to pick up on it again. IIRC we had just about finished the thought-work/discusions and all that remained was to implement and deploy.

COMPLETED: Bill has started work on deployment - I agree with his proposal.
 * Bill 16Dec11: Deployed.
 * Peter 18Dec11:I approve of what Bill has done here - any nay-sayers?

Track Drop-Down Menu
The ToDo-2 here depends on the release and deployment of Bill's new proposed Splitting & Joining Tracks page – see Audio Tracks and Audacity Tracks and Clips above.

COMPLETED: Bill has started work on deployment - I agree with his proposal.
 * Bill 16Dec11: Deployed.
 * Peter 18Dec11:I approve of what Bill has done here - any nay-sayers?

Audio Tracks
See Audacity Tracks and Clips above: implement & deploy

COMPLETED: Bill has started work on deployment - I agree with his proposal.
 * Bill 16Dec11: Deployed.
 * Peter 18Dec11:I approve of what Bill has done here - any nay-sayers?
 * Peter 21Dec11: I moved the ToDo-2 to lower down that page: I thought we'd agreed to lose the "Splitting and Joining Tracks" from this page ?
 * Peter 23Dec11: Bill responded and I agree with his response - so I have closed this ToDo2

Tutorial - Your First Recording
Gale has requested more info on: software playthrough, overdub and latency. (He did suggest pointing software playthrough and overdub at the “relevant FAQ” – but there are currently no FAQ ebtries for these two terms). I will undertake the work on this. I am considering fitting in a new sub-tutorial step inbetween the current steps 1 and 2. This new step will cover Audacity settings; some of that currently lives in the existing step 2, I propose to move it into the new subtutorial along with material on software playthrough, overdub and latency.

COMPLETED: I have done most of the work on drafting this. The two subtutorials that I propose will replace the current YFR>Selecting Your Input may be viewed in my user space. If there is no dissent by early next week I will implement these changes. The only thing I am unsure about is the "Audacity Settings For Recording" title - I am very open to alternative suggestions on that.

Bill has reviewed these and likes the content.
 * Peter 19Dec11: as there wer no nay-sayers I published the new content/format today

MediaWiki:Sidebar
This is just the navigation side-bar – requires no attention (apart from the fact the the “ToDo 2” word-wraps which is unsightly (but only affects editors).

FIXED: Gale has changed the nav. sidebar to show "P1, P2, Px" so wrapping no longer occurs.

File Menu > Export MIDI...
Bill wrote some text for the “Export MIDI…” a while back, but has appealed for someone who knows more about MIDI than him to review it. I have no MIDI knowledge or experiencs so I cannot review this.

FIXED: Bill demoted this and Steve dealt with the outsanding ToDo.
 * steve 16Dec 2011: There is a possible bug in Export MIDI. I've added an editornote about it but how should bug features be documented?

Playing and Recording
Back in July Gale commented that he thought this “looked a bit threadbare”. He went on to document the Transport Toolbar buttons and the shortcuts. Persnoally I think this page is ok now, at most it would be an unclassified ToDo certainly not a ToDo-2. Can we remove the ToDo-2 or demote it?

DEMOTED: Bill suggested demoting this to a ToDo and Gale agreed.

ToDo
This page documents the ToDo methodology – but also historically it used to be the page for collecting action items, many of which were dealt with long ago or are no longer applicable Requires no attention for ToDo-2s – but at some stage maybe we should clear out the action items, replacing them with appropriate ToDos on the relevant pages as this is now the methodolgy we are using.

NO ACTION REQUIRED:

Toolbars Overview
Requires the graphic image for the Device Toolbar changing so that is shows the newer default stereo mode. I tried to do this back in July but I couldn’t get the washed-out grey tone of the existing image (and that of the other images on the page).

FIXED: Ed has replaced the image.

Welcome For Editors
No actionable ToDo-2s, requires no attention. The page documents the ToDo methodology for editors. It obviously overlaps with the ToDo page – and there is some repeated material.

NO ACTION REQUIRED:

DEMOTED: In line with Bill's demotion of the English version - translation of Steve's updates in the English version still to be done.
 * Bill 16Dec11: It appears that the ToDo-2 has been removed from this page - it no longer appears in the list of pages linked to the ToDo-2 page.
 * Peter17Dec11: That's because I demoted it to a ToDoin line with what you did the English version Bill (it should vertain;y not be a 2.0 RC blocker).

File Menu/de
COMPLETED: This is Bill’s MIDI export stuff translated (along with its ToDo-2) – see File Menu above. If Bill’s text on the File Menu page is approved then we can remove this ToDo-2. If further text is added it will require translation by German editors.
 * Peter 21dec11: This hasbeen reviewd and ok'd in the English version so i have marked it here as completed and removed the ToDo

View Menu/de
This is the request to document the “Undo Levels” and “Discard” – see View Menu above. Once further text is added to the View Menu page it will require translation by German editors.

COMPLETED: Bill comments that the English version needs quite a bit of work, including what kind of images are appropriate.

I propose that we conside demoting this to a ToDo so that it does not remain a blocker to a 2.0 RC. Anybody agree/disagree?
 * Peter 19Dec11: this one will disapppear if we adopt Bill's suggestion for the View Menu page, moving the "gory details" to the Undo, Redo and History page.
 * Peter 21Dec11: This page is now out of step with its English equivalent as Bill has provided a link to the revised Undo, Redo and History page in the preocess removing the two existing troublesome images and their corresponding text. Also this page still has the formatting (bolding) problem that was present on the English page.
 * Peter 21Dec11: I managed to fix the bolding problem (I remembered how Bill said he fixed the English page).
 * Peter 21Dec11: Frau Turler (that's Mrs. Waxcylinder) provided a German translation (she is Swiss) of the link text to the revised Undo, Redo and History page.