Re: MOTU documentation for beginners
Well, please excuse all my babbling before, I notice on https://wiki.ubuntu.com/Packaging/Training that classes are happening way more often than I thought. Sorry about it and if there's anything I can do to help I'm here and willing! On Thu, Jan 14, 2010 at 3:58 PM, Jonathan Carter (highvoltage) wrote: > Hi Daniel -- Ubuntu-motu mailing list Ubuntu-motu@lists.ubuntu.com Modify settings or unsubscribe at: https://lists.ubuntu.com/mailman/listinfo/ubuntu-motu
Re: MOTU documentation for beginners
Hi Daniel On Thu, Jan 14, 2010 at 9:28 AM, Daniel Holbach wrote: > On 13.01.2010 13:30, Jonathan Carter (highvoltage) wrote: >> I had similar problems when I first started reading MOTU >> documentation, some sections are very long-winded, I think in some >> cases it's very difficult to keep it short and still explain >> everything that needs to be explained. > > Can you explain which of these you are referring to? What specifically > would you like to see fixed? I think I was a bit unfair there, glancing over the documentation on the wiki it seems much better than I remember it. Perhaps it improved a lot since I looked at it, or maybe I've become more patient. > And you're lucky... https://wiki.ubuntu.com/UbuntuDeveloperWeek is > happening in just a few days. :-) Yes that's awesome! >> Perhaps it would be better to fix up the current documentation, >> updating it and perhaps break some of the larger pieces into smaller >> chunks, and also have more classes available and make more videos, >> rather than starting a new docs project from scratch for this? > > If you have a look at the wiki "source" you'll see that the sections are > broken up in small chunks, so they can be reorganised easily. Yep, what I'm basically saying to Rami is that it would probably be much less work making the current documentation more friendly and beginners friendly where it needs to be so, rather than starting more documentation from scratch. > Which additional classes and videos would you like to see? A video covering merging would be really nice. I don't have all the answers yet but I was thinking before that it may be useful to have a kind of motu-school with a 12 week cycle where topics are covered in classes every week from beginner to intermediate or maybe even higher and presented by the motu mentors. That way someone could know that if they follow the process they could at least become reasonably comfortably with the Ubuntu packaging processes in a certain time frame. There could be tests after each week so that people could test their own progress and knowledge, and if they do well I guess that could be used to show to a developers board to show that they know all the basics when it comes to being a motu. Like I said, I don't have all the answers myself and it may be too much work and difficult for some people to follow, but having more regular classes and knowing what to expect from those classes could be very useful imho. I'm not sure how many people are interested in becomming MOTU's at the moment. > Who would like to help out with any of this? We're still looking for > people willing to give sessions: https://wiki.ubuntu.com/Packaging/Training I'm a MOTU and I know at least the basics, if no one minds then I'd like to present one, if it's a topic I'm not familiar with I might just need a few days before the time to prepare and get comfortable with the content. -Jonathan -- Ubuntu-motu mailing list Ubuntu-motu@lists.ubuntu.com Modify settings or unsubscribe at: https://lists.ubuntu.com/mailman/listinfo/ubuntu-motu
Re: MOTU documentation for beginners
On 13.01.2010 13:30, Jonathan Carter (highvoltage) wrote: > I had similar problems when I first started reading MOTU > documentation, some sections are very long-winded, I think in some > cases it's very difficult to keep it short and still explain > everything that needs to be explained. Can you explain which of these you are referring to? What specifically would you like to see fixed? > What I found quite useful is > the classes that took place in #ubuntu-classroom over the openweeks > and developer weeks. I think it's especially useful when something > tiny that could be a blocker gets in the way and then someone could > ask about it immediately. And you're lucky... https://wiki.ubuntu.com/UbuntuDeveloperWeek is happening in just a few days. :-) > Perhaps it would be better to fix up the current documentation, > updating it and perhaps break some of the larger pieces into smaller > chunks, and also have more classes available and make more videos, > rather than starting a new docs project from scratch for this? If you have a look at the wiki "source" you'll see that the sections are broken up in small chunks, so they can be reorganised easily. Which additional classes and videos would you like to see? Who would like to help out with any of this? We're still looking for people willing to give sessions: https://wiki.ubuntu.com/Packaging/Training Have a great day, Daniel -- Ubuntu-motu mailing list Ubuntu-motu@lists.ubuntu.com Modify settings or unsubscribe at: https://lists.ubuntu.com/mailman/listinfo/ubuntu-motu
Re: MOTU documentation for beginners
Hi Rami On Wed, Jan 13, 2010 at 6:04 AM, Rami Eid wrote: > I would like to see the MOTU tutorials more friendly and contains a section > for getting it done even in poor quality for the beginners and separate > documents for the people who are planning to participate in MOTU efforts. > Increasing the size of the people who know how to package and use launchpad > for distributing their software personally will defintely increase the size > of the MOTU team on the long run. I had similar problems when I first started reading MOTU documentation, some sections are very long-winded, I think in some cases it's very difficult to keep it short and still explain everything that needs to be explained. What I found quite useful is the classes that took place in #ubuntu-classroom over the openweeks and developer weeks. I think it's especially useful when something tiny that could be a blocker gets in the way and then someone could ask about it immediately. Perhaps it would be better to fix up the current documentation, updating it and perhaps break some of the larger pieces into smaller chunks, and also have more classes available and make more videos, rather than starting a new docs project from scratch for this? -Jonathan -- Ubuntu-motu mailing list Ubuntu-motu@lists.ubuntu.com Modify settings or unsubscribe at: https://lists.ubuntu.com/mailman/listinfo/ubuntu-motu