On 14/06/2012 23:10, Gale Andrews wrote:
> | From Martyn Shaw<martynshaw99@...>
> | Wed, 13 Jun 2012 01:03:11 +0100
> | Subject: [Audacity-quality] [Audacity-devel] 2.0.1?
>> On 11/06/2012 23:59, Vaughan Johnson wrote:
>>> On 6/9/2012 4:48 PM, Martyn Shaw wrote:
>>>> Just a reminder about what we agreed about the manual
>>>> so I will update
>>>> http://wiki.audacityteam.org/wiki/Release_Process#Process step 5, if
>>>> that is OK with RM.
>>> Yes, please.
>> OK, I've attempted to do that, but this is a new protocol for us and
>> so should be seen as 'experimental', I feel. I intend to do/follow it
>> for this release and will update as I go along. It will result in the
>> same manual for all OSs, and an archive of manuals on Google code.
>> There are some risks that the manual version may not be the same in
>> all the releases, but they are less than before.
> I don't think there should be any risk if we co-ordinate properly?
Indeed. That 'if' == 'risk'.
>> Does anybody know what links to
>> http://manual.audacityteam.org/help.zip ? We are going to have to
>> update that process / naming.
> There will be a number of links to that in the Manual and on the
> main web site. I assume (if I do the web changes) that I will look
> after relinking to google code when I know the URL (which will
> be different for each release if it's a direct link to the Manual, as
> I think it should be).
In the current proposal/wiki,
http://wiki.audacityteam.org/wiki/Release_Process#Process 9.1 gives
the process and
gives the file name (just added the last para).
> I can't give you a list of pages that link to help.zip right now.
> Do you need to know?
No, not really, but it is an issue that I thought I'd bring up. If
you are onto it, I'll ignore it.
> Also, can I ask about the online version of the released (frozen)
> Manual that we point users to for technical support:
> http://manual.audacityteam.org/help/manual/index.html ?
> Currently this is produced merely by taking the dumped Manual with
> the structure it has and uploading it to manual.audacityteam.org.
> However for pages inside the structure this gives a yet longer path
> of help/manual/man e.g.:
> http://manual.audacityteam.org/help/manual/man/preferences.html .
I'm sorry, why the current manual isn't at
http://manual.audacityteam.org is a mystery to me. And why we have
the complicated dir structure within the local manual is also a
mystery. I'm sure there is a good reason. If I'd have done it I'd
probably have dropped all the files into the one dir in a complete
mess, but that could result in conflicting file names.
> I guess we need a script if we were to use a simpler structure for
> the online viewable version, but Richard AFAIR suggested some kind
> of redirect might be good meantime.
> Currently, http://manual.audacityteam.org/man/ is the entry point
> for the alpha manual that we don't want most users to see, but it's
> actually a much better URL for the online released Manual than what
> we have now.
> I suggested to Buanzo that we could make http://manual.audacityteam.org/dev
> the working link for the alpha development manual and
> http://manual.audacityteam.org/man the working link for the online
> viewable released manual. He said that was fine to set it up like that.
> Or if we leave the alpha manual link as it is now, we could use a
> shorter link for the online released manual e.g.
> http://manual.audacityteam.org/m/ .
> BTW I think most of us working on the Manual prefer the current
> sidebar links on http://manual.audacityteam.org/help/manual/index.html
> * Alpha Manual
> * Translate this Manual
> * Audacity Download
> to what \scripts\mw2html_audacity\sidebar.html currently has
> * Local manual in use (which is a circular link back to the Manual
> home page)
> * Internet manual
> Live Security Virtual Conference
> Exclusive live event will cover all the ways today's security and
> threat landscape has changed and how IT managers can respond. Discussions
> will include endpoint security, mobile security and the latest in malware
> threats. http://www.accelacomm.com/jaw/sfrnl04242012/114/50122263/
> Audacity-quality mailing list