Re: Getting started wiki page (was: Hello there)

2009-01-24 Thread Siegfried-Angel
Wow, nice. Some comments from having a quick look at it:

 - It'd add a statement saying that changes on LP staging will be lost
(people may do something useful and the get annoyed that it got
deleted).

 - I don't think that the translation exercise is a good idea. There
are several language teams (like, for example, the Catalan one) who
have a workflow other than just go to LP and translate (in our case,
read an introduction on how to translate stuff -how to structure
sentences, which terminology to use, etc-, subscribe a ML, announce
there what you're working one and finally send the .po there for
review; suggestions from Launchpad are ignored in most cases, and they
are generally also of poor quality because those who wrote them didn't
read the guidelines).

--
Siegfried-Angel Gevatter Pujals (RainCT)
Ubuntu Developer. Debian Contributor.

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


Re: Getting started wiki page (was: Hello there)

2009-01-23 Thread James Westby
On Sun, 2009-01-11 at 23:00 +0100, Kjeldgaard Morten wrote:
 I have now produced a draft page at 
 https://wiki.ubuntu.com/GettingStartedDraft 
   , incorporating all ideas contributed to me (the number is zero ;-)).

Hi Morten,

Thanks for working on this, I think the page is great.

I'm not sure it should become the new GettingStarted page though, as in
the page that is the landing page for people interested in getting 
started. It should certainly be a prominent link from that page though.

The reason for this is that the page is quite long, and leads you 
through a journey to learn a lot. I think the landing page itself
should be quite short and focused, and just give a few links to the
basic information, and then point them to this page to get started.

Perhaps this should indeed be called the GettingStarted page, and we 
should have the landing page be called something else, I'm not too
fussed, but I hope my point is clear.

Thanks again for working on this, it is quite an achievement.

Thanks,

James


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


Re: Getting started wiki page

2009-01-12 Thread Kjeldgaard Morten

On 12/01/2009, at 05.10, Jonathan Marsden wrote:

 Also, I think adding a table of contents to the page would be good (I
 just did this!).

Great, that makes it easier to get back to the section you are working  
on! Ideally, I would have liked some kind of check-box for every  
exercise that people could tick off to mark how far they've gotten,  
but I don't think that's possible within the Moinmoin framework.

I started the exercise sections as a way to put in links to explore,  
but with the implicit message come back here when you're done  
reading. In general, I think the problem with the Wiki approach where  
everything is marked by a link is that it's easy to get lost and  
distracted. Therefore, when you add a link to the document, consider  
formulating it as an exercise for people to do.

  One idea: Perhaps each major section should
 have a Further Resources bit at the end which links to more detail
 about the particular topic concerned
 (Launchpad/Triage/bugfixing/packaging/whatever)?

I think it's better to save all the Further Reading links until the  
end of the document - where they could be organized in a table or list  
corresponding to the content. The reason is not to distract the reader  
too much from the flow of the document and exercises. So again: if  
there's a link you think is vital for the reader to visit, consider  
formulating it as an exercise, possibly with some questions to answer  
afterward.

 I'm slightly confused as to the expected path users (wannabe community
 members) would take to get to this page (say from http://www.ubuntu.com 
 )
 and (if they are MOTU-wannabes) from here to MOTU-specific material.
 How does the new more general GettingStarted page you are creating
 relate to existing non-MOTU-specific pages of a somewhat similar  
 nature,
 such as https://wiki.ubuntu.com/UbuntuDevelopment and
 https://wiki.ubuntu.com/ContributeToUbuntu ?


The current Getting Started wit h MOTU document is the one we've  
been pointing newcomers at, but I think that document misses the mark  
and turns away a lot of not-so-technical people. On the other hand,  
MOTU-hopefuls also need to learn about the workflow, so the general  
introduction is a fair requirement before going into the more MOTU- 
specific stuff. So my feeling is that all community wannabes should be  
pointed to this document as their first step, and the document should  
help them find out where they best can help out.

Cheers,
Morten


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


Re: Getting started wiki page

2009-01-12 Thread Daniel Holbach
-BEGIN PGP SIGNED MESSAGE-
Hash: SHA1

Kjeldgaard Morten schrieb:
 I have now produced a draft page at 
 https://wiki.ubuntu.com/GettingStartedDraft 
   , incorporating all ideas contributed to me (the number is zero ;-)).
 
 The main idea is to give a gentle introduction suited for the people  
 we meet on the mailing lists or IRC asking Hi, I'm interested in  
 Ubuntu, how can I help out?.

Thanks a lot for working on this. You are clearly a rockstar.

It's a great start and I think that it would live well at
MOTU/GettingStarted

I still maintain the points that I mentioned in an earlier mail (1. very
concise landing page, 2. only one page to bookmark because it links to
all the relevant stuff and 3. don't duplicate other parts of the wiki).
What do you think about
 - refining the current MOTU/GettingStarted page
 - make the current text a the very short version section
 - make your text the explanation and exercises section?

This way I feel we'd still have the best of both. :-)

Have a great day,
 Daniel

- --
My 5 today: #315769 (last-align), #315535 (ubuntu), #315881 (nautilus-
sendto), #309684 (exiv2), #316026 (imlib2)
Do 5 a day - every day! https://wiki.ubuntu.com/5-A-Day
-BEGIN PGP SIGNATURE-
Version: GnuPG v1.4.9 (GNU/Linux)
Comment: Using GnuPG with Mozilla - http://enigmail.mozdev.org

iEYEARECAAYFAklrGfEACgkQRjrlnQWd1esuCQCeMyWcPN1w29tLyj96wQbItdAE
A4EAn2ZxloadriwqDQ1GIMlUtrVtfytu
=Bc3d
-END PGP SIGNATURE-

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


Re: Getting started wiki page

2009-01-12 Thread Christophe Sauthier
On Mon, Jan 12, 2009 at 10:11 AM, Kjeldgaard Morten m...@bioxray.au.dk wrote:

 On 12/01/2009, at 05.10, Jonathan Marsden wrote:
 I'm slightly confused as to the expected path users (wannabe community
 members) would take to get to this page (say from http://www.ubuntu.com
 )
 and (if they are MOTU-wannabes) from here to MOTU-specific material.
 How does the new more general GettingStarted page you are creating
 relate to existing non-MOTU-specific pages of a somewhat similar
 nature,
 such as https://wiki.ubuntu.com/UbuntuDevelopment and
 https://wiki.ubuntu.com/ContributeToUbuntu ?

 The current Getting Started wit h MOTU document is the one we've
 been pointing newcomers at, but I think that document misses the mark
 and turns away a lot of not-so-technical people. On the other hand,
 MOTU-hopefuls also need to learn about the workflow, so the general
 introduction is a fair requirement before going into the more MOTU-
 specific stuff. So my feeling is that all community wannabes should be
 pointed to this document as their first step, and the document should
 help them find out where they best can help out.

I also think it might be great to mention the motu mentoring program
as a way to continue that start in the Ubuntu World...

  Chris


-- 
Ma vie   |
Mes recettes  |  http://www.reponses.net
Mes images   |

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


Re: Getting started wiki page (was: Hello there)

2009-01-11 Thread Kjeldgaard Morten
Hi,

 I volunteer to draft a new GettingStarted page, and I will collect  
 with
 gratitude any contributions from this list or otherwise.

 Excellent.
 I'm happy to review, improve and discuss. The only thing I'd like
 MOTU/GettingStarted to be is
 - a concise landing page
 - that links to all the important pages (so we have one good answer  
 and
 the new contributor one page to bookmark)
 - and gets people a sense of direction


I have now produced a draft page at https://wiki.ubuntu.com/GettingStartedDraft 
  , incorporating all ideas contributed to me (the number is zero ;-)).

The main idea is to give a gentle introduction suited for the people  
we meet on the mailing lists or IRC asking Hi, I'm interested in  
Ubuntu, how can I help out?.

The current introduction aims at steering people directly towards a  
MOTU career, but I have adopted a completely different strategy in the  
draft document. With this approach newcomers are taught:

* Launchpad
* Bug work and triaging
* The workflow of packages in Ubuntu
* How Ubuntu development is organized in the various teams
* The Ubuntu release model (not yet written)

The document includes practical exercises that gets people started  
with various tasks that most of us use every day. People are invited  
to join mailing lists and IRC, show up and ask questions, examine  
various Launchpad pages etc.

It is always difficult to arrive at the right level of a training  
document. However, even the most experienced developer does not  
(necessarily) know how Ubuntu's bug flow works, and will benefit from  
an introduction.

The document is a draft, with a lot of shortcomings and lacking  
features, but it does outline an alternative educational approach that  
I think could be useful and productive. Please feel free to add and/or  
correct the Wiki document, so we as quickly as possible can start a  
systematic and fruitful education of new Ubuntu enthusiasts with a  
desire to help out!

 Agreed, though I'm not sure this should be in the MOTU namespace -  
 what
 do you think?


Yes. I think the MOTU namespace should only contain material that is  
strictly relevant to the MOTU team. We need a howto become MOTU  
page; the current MOTU/GettingStarted perhaps needs some revision  
based on the more granular training we now have with the new  Ubuntu  
Contributor team.

Cheers,
Morten

-- 
Morten Kjeldgaard m...@ubuntu.com
Ubuntu MOTU Developer
GPG Key ID: 404825E7


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


Re: Getting started wiki page

2009-01-11 Thread Jonathan Marsden
Kjeldgaard Morten wrote:

 I have now produced a draft page at 
 https://wiki.ubuntu.com/GettingStartedDraft 

Looks like a good start.

 - that links to all the important pages (so we have one good answer and
 the new contributor one page to bookmark)

The draft doesn't really meet this goal yet, I think.  I'll see about
adding a few more links.  One idea: Perhaps each major section should
have a Further Resources bit at the end which links to more detail
about the particular topic concerned
(Launchpad/Triage/bugfixing/packaging/whatever)?

Also, I think adding a table of contents to the page would be good (I
just did this!).

I'm slightly confused as to the expected path users (wannabe community
members) would take to get to this page (say from http://www.ubuntu.com)
and (if they are MOTU-wannabes) from here to MOTU-specific material.
How does the new more general GettingStarted page you are creating
relate to existing non-MOTU-specific pages of a somewhat similar nature,
such as https://wiki.ubuntu.com/UbuntuDevelopment and
https://wiki.ubuntu.com/ContributeToUbuntu ?

Jonathan

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