Re: [ubuntu-studio-devel] New User Documentation

2015-10-22 Thread Kaj Ailomaa
On Wed, Oct 21, 2015, at 01:28 PM, C. F. Howlett wrote:
> I have had a project in mind for some time.
> 
> Ubuntu used to include GIMP.  On the desktop, there was a tutorial to 
> introduce very basic GIMP functions in the form of a user-built Ubuntu 
> logo image.  Cool stuff.  Sadly, removed in later releases. Likewise the 
> old Ubuntu sample media folder.
> 
> So, to my project;
> 
> Target audience: "I just installed ubuntustudio.  Now what?" people
> 
> Format: a series of easy peasy, introductory tutorials using the major 
> apps in the focus areas.  For instance:
> 
> SOUND > AUDACITY > Record your voice.  Sample and remove background 
> noise.  Edit sound for  Darth Vader voice.  Save and export.
> 
> Upon completion of the project, supply at least one tutorial. 
> Fortunately, the major apps already have basic tutorials.  We just need 
> to highlight them.
> 
> Obviously, this is not the in-depth documentation currently under 
> discussion in another channel, but I believe it fills a need and would 
> give useful and welcome advice.
> 
> I'm not qualified to do all the tutorials, but I am willing to edit and 
> standardize the writing.  Any interest???
> 


This sounds a bit like the idea we had for the youtube videos. Practical
tutorials sort of thing. I wouldn't mind having both videos and text,
though as you say, there are existing tutorials for most major
applications. Doesn't mean we can't make our own.

I'm thinking about how documentation should be organized. Tutorials
would deserve their own section. If we have a main "Documentation" page
on our website, it could have several subpages, and one of them could be
something equivalent to "Tutorials", where you can find all sorts of
resources, either our own made material, or links to existing stuff.

So, I'm all for it.

-- 
ubuntu-studio-devel mailing list
ubuntu-studio-devel@lists.ubuntu.com
Modify settings or unsubscribe at: 
https://lists.ubuntu.com/mailman/listinfo/ubuntu-studio-devel


Re: [ubuntu-studio-devel] New User Documentation

2015-10-21 Thread Ralf Mardorf
On Wed, 21 Oct 2015 13:33:02 +0100, floccul...@gmx.co.uk wrote:
>On 21/10/15 12:55, Ralf Mardorf wrote:
>> On Wed, 21 Oct 2015 19:28:38 +0800, C. F. Howlett wrote:  
>>> I'm not qualified to do all the tutorials, but I am willing to edit
>>> and standardize the writing.  Any interest???  
>> A proofreader [translator for Phantom English to English English]
>> would be useful for the Ubuntu (Studio) help and Wiki pages ;).
>>  
>perhaps host it on LP like xubuntu-docs
>
>then even when it's dealt with now - fixes can be followed from bug to
>fix
>
>it can also then (I assume) be translated as well
>
>just a thought

I just wanted to point out that users like me probably have knowledge
about a software domain, but will write help pages and Wikis in broken
English. Since everybody can create an Ubuntu One account, everybody
can edit the help pages and Wikis. Any changes made are stored by the
page histories, so nothing gets lost, if somebody edits it, even if
somebody by accident should remove the entire text.

We shouldn't invent concepts of rocket science to provide help
pages/Wikis. The concept of a Wiki is very simple and already worked for
a long time. Let's stay with the KISS principle,
https://en.wikipedia.org/wiki/KISS_principle.

If you find any errors or if you even could provide useful links go and
edit

https://help.ubuntu.com/community/UbuntuStudio/UserGuide/Graphics/draftpage
https://help.ubuntu.com/community/UbuntuStudio/UserGuide/Video
https://help.ubuntu.com/community/UbuntuStudio/TroubleShooting
https://help.ubuntu.com/community/CategoryUbuntuStudio

and other pages.

Some contributed much, e.g. Set and Kaj, others contributed close to
nothing, e.g. me. Many a little makes a mickle. The German
equivalent saying: "Small domestic animals poo too." (Kleinvieh macht
auch Mist.)

Regards,
Ralf

PS: Unfortunately the login is a PITA. It takes very long and often
fails.

-- 
ubuntu-studio-devel mailing list
ubuntu-studio-devel@lists.ubuntu.com
Modify settings or unsubscribe at: 
https://lists.ubuntu.com/mailman/listinfo/ubuntu-studio-devel


Re: [ubuntu-studio-devel] New User Documentation

2015-10-21 Thread flocculant

On 21/10/15 12:55, Ralf Mardorf wrote:

On Wed, 21 Oct 2015 19:28:38 +0800, C. F. Howlett wrote:

I'm not qualified to do all the tutorials, but I am willing to edit
and standardize the writing.  Any interest???

A proofreader [translator for Phantom English to English English]
would be useful for the Ubuntu (Studio) help and Wiki pages ;).


perhaps host it on LP like xubuntu-docs

then even when it's dealt with now - fixes can be followed from bug to fix

it can also then (I assume) be translated as well

just a thought


--
ubuntu-studio-devel mailing list
ubuntu-studio-devel@lists.ubuntu.com
Modify settings or unsubscribe at: 
https://lists.ubuntu.com/mailman/listinfo/ubuntu-studio-devel


[ubuntu-studio-devel] New User Documentation

2015-10-21 Thread C. F. Howlett

I have had a project in mind for some time.

Ubuntu used to include GIMP.  On the desktop, there was a tutorial to 
introduce very basic GIMP functions in the form of a user-built Ubuntu 
logo image.  Cool stuff.  Sadly, removed in later releases. Likewise the 
old Ubuntu sample media folder.


So, to my project;

Target audience: "I just installed ubuntustudio.  Now what?" people

Format: a series of easy peasy, introductory tutorials using the major 
apps in the focus areas.  For instance:


SOUND > AUDACITY > Record your voice.  Sample and remove background 
noise.  Edit sound for  Darth Vader voice.  Save and export.


Upon completion of the project, supply at least one tutorial. 
Fortunately, the major apps already have basic tutorials.  We just need 
to highlight them.


Obviously, this is not the in-depth documentation currently under 
discussion in another channel, but I believe it fills a need and would 
give useful and welcome advice.


I'm not qualified to do all the tutorials, but I am willing to edit and 
standardize the writing.  Any interest???


--
ubuntu-studio-devel mailing list
ubuntu-studio-devel@lists.ubuntu.com
Modify settings or unsubscribe at: 
https://lists.ubuntu.com/mailman/listinfo/ubuntu-studio-devel


Re: [ubuntu-studio-devel] New User Documentation

2015-10-21 Thread Ralf Mardorf
On Wed, 21 Oct 2015 19:28:38 +0800, C. F. Howlett wrote:
>I'm not qualified to do all the tutorials, but I am willing to edit
>and standardize the writing.  Any interest???

A proofreader [translator for Phantom English to English English]
would be useful for the Ubuntu (Studio) help and Wiki pages ;).

-- 
ubuntu-studio-devel mailing list
ubuntu-studio-devel@lists.ubuntu.com
Modify settings or unsubscribe at: 
https://lists.ubuntu.com/mailman/listinfo/ubuntu-studio-devel