how to contribute / German documentation

Feedback and Reviews for Audacity 2.x
Forum rules
This board is ONLY for general feedback and discussion about Audacity 2.X.

If you require help, or think you have found a "bug", please post on the forum board relevant to your operating system.
Windows
Mac OS X
GNU/Linux and Unix-like
SqueezeBoxer
Posts: 15
Joined: Tue Dec 15, 2020 6:27 pm
Operating System: Windows 10

how to contribute / German documentation

Post by SqueezeBoxer » Fri Dec 18, 2020 10:44 am

I'm new to Audacity and think it is a great project. Alas it is not easy to find German documentation. Most of what I could find is pretty incomplete or outdated. Some of my (German) fellow musicians are not so fluent in English, so I will have to write down some tipps & tricks for them. This might be useful also for other users so I would be willing to share it. How can I get write access to both the German and English wiki?
I can see requests for contribution in various places but it's not clearly specified what to do to get in contact!

steve
Site Admin
Posts: 78719
Joined: Sat Dec 01, 2007 11:43 am
Operating System: Linux *buntu

Re: how to contribute / German documentation

Post by steve » Fri Dec 18, 2020 2:22 pm

Hi SqueezeBoxer,
do you have any experience editing wikis (for example, Wikipedia)?
9/10 questions are answered in the FREQUENTLY ASKED QUESTIONS (FAQ)

SqueezeBoxer
Posts: 15
Joined: Tue Dec 15, 2020 6:27 pm
Operating System: Windows 10

Re: how to contribute / German documentation

Post by SqueezeBoxer » Sat Dec 19, 2020 7:24 pm

In my day job as a software developer we use a MediaWiki on the intranet to share know-how and information.

steve
Site Admin
Posts: 78719
Joined: Sat Dec 01, 2007 11:43 am
Operating System: Linux *buntu

Re: how to contribute / German documentation

Post by steve » Sat Dec 19, 2020 10:40 pm

Good, that's useful.

Both the Audacity manual and Audacity wiki are huge (and the manual is updated as necessary for each Audacity release). Would you be interested in taking on a specific section, for example the Audacity Tour Guide, or the Getting Started ("Quick Help") guide?
9/10 questions are answered in the FREQUENTLY ASKED QUESTIONS (FAQ)

SqueezeBoxer
Posts: 15
Joined: Tue Dec 15, 2020 6:27 pm
Operating System: Windows 10

Re: how to contribute / German documentation

Post by SqueezeBoxer » Sun Dec 20, 2020 9:51 pm

I'm afraid I won't find the time to translate whole chapters of the manual. I mainly plan to share what I investigate and write down for myself and my German friends. e.g. my link collection https://start.me/p/vja9kM/musik-audacity would be better located in the wiki than hidden somewhere in the forum.
These pages definitely need a reworK and should be moved to the wiki:
https://www.audacity-forum.de/index.php ... thelfen-d/
https://www.audacity-forum.de/download/ ... ntents.htm

One more idea: a forum post recommended using the current English manual via Google translator:
https://translate.google.de/translate?s ... tyteam.org
The result is quite useful and better as expected, but it definitely contains some strange words and sentences.
How about publishing a machine translated German manual in wiki format and providing a possibility for the community to fix the glitches?

steve
Site Admin
Posts: 78719
Joined: Sat Dec 01, 2007 11:43 am
Operating System: Linux *buntu

Re: how to contribute / German documentation

Post by steve » Mon Dec 21, 2020 10:01 am

SqueezeBoxer wrote:
Sun Dec 20, 2020 9:51 pm
These pages definitely need a reworK and should be moved to the wiki:
Those pages are from an independent (unofficial) Audacity forum. We have no control over the content of audacity-forum.de

We link to that forum because it has been a very active and well supported German language forum for Audacity. Is that still the case?
9/10 questions are answered in the FREQUENTLY ASKED QUESTIONS (FAQ)

SqueezeBoxer
Posts: 15
Joined: Tue Dec 15, 2020 6:27 pm
Operating System: Windows 10

Re: how to contribute / German documentation

Post by SqueezeBoxer » Mon Dec 21, 2020 11:11 am

https://www.audacity-forum.de is still active. It seems to be THE German Audacity forum. I noticed that it is independent because I had to register there independently.
Just the mentioned forum entries are outdated (from 2012) and many links don't work anymore.
The forum entry "Wo gibt es die deutschen Audacity Bedienungsanleitungen? - Wie kann ich mithelfen die Bedienungsanleitung zu übersetzen?" (where can I find the German manual? How can I help to translate the manual?) by user edgar-rft is a helpful guide, just outdated. edgar-rft seems to have left the forum, he is listed with "last activity 2012-10-15"
I'd like to copy that forum entry to the German wiki https://wiki.audacityteam.org/wiki/De and update it there. What is necessary that I can do that?

steve
Site Admin
Posts: 78719
Joined: Sat Dec 01, 2007 11:43 am
Operating System: Linux *buntu

Re: how to contribute / German documentation

Post by steve » Mon Dec 21, 2020 5:05 pm

SqueezeBoxer wrote:
Sun Dec 20, 2020 9:51 pm
These pages definitely need a reworK and should be moved to the wiki:
https://www.audacity-forum.de/index.php ... thelfen-d/
https://www.audacity-forum.de/download/ ... ntents.htm
I think this: https://www.audacity-forum.de/download/ ... ntents.htm is too big and too old to be worth the effort. Better to work from more up to date information.

For this page: https://www.audacity-forum.de/index.php ... thelfen-d/
I'd suggest that you post a reply to that post with an updated version of the original information.
SqueezeBoxer wrote:
Sun Dec 20, 2020 9:51 pm
How about publishing a machine translated German manual in wiki format and providing a possibility for the community to fix the glitches?
I think that's a good idea IF there are experienced German users that are willing to fix the glitches.

I'm looking for ways to move this forward, but I'm not an administrator for the Audacity wiki (I just have an "editor" account). The wiki was originally open for public contributions, but it was abused by spammers and the amount of work required managing users greatly outweighed the benefit. Accounts are now restricted to people that have the desire and the time to contribute to documentation on an ongoing basis. If you have the time and inclination to do so, then I can forward your email address to the wiki admin.

You are very welcome to post articles here on this forum, and then there is the option for articles to be copied from the forum to the wiki (which I can do).
9/10 questions are answered in the FREQUENTLY ASKED QUESTIONS (FAQ)

SqueezeBoxer
Posts: 15
Joined: Tue Dec 15, 2020 6:27 pm
Operating System: Windows 10

Re: how to contribute / German documentation

Post by SqueezeBoxer » Fri Dec 25, 2020 5:56 am

On e.g. https://wiki.audacityteam.org/wiki/Support_other_Users you pretend to be looking for contributors. If this is really the case I recommend to make it easier to become one.

steve
Site Admin
Posts: 78719
Joined: Sat Dec 01, 2007 11:43 am
Operating System: Linux *buntu

Re: how to contribute / German documentation

Post by steve » Sat Dec 26, 2020 11:21 am

I agree SqueezeBoxer, but it's become a bit of a "Catch 22". Audacity needs more active contributors, but someone has to "manage" that (set up the accounts, help new contributors if they get stuck, repair any spamming / vandalism, keep new contributors up to date with new developments ...). I do that for this forum (with help from the forum "elves"), but I don't have time (or access) to do that for the wiki.

If someone has a track record in contributing to open source software / Wikipedia / other, then I might stick my neck out and recommend that the SysAdmin opens an account for them. As I wrote previously, it has been a big problem in the past to just give an account to everyone that asks. This really is something that the Audacity team needs to resolve, and I think it will be high on the agenda next year after we have released Audacity 3.0.0.

Perhaps I could forward your email address to the wiki admin and ask them to email you directly? As the forum admin I can access your email address from your forum account, but we don't like to do that without asking.
9/10 questions are answered in the FREQUENTLY ASKED QUESTIONS (FAQ)

Post Reply