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
MOTU documentation for beginners
Dear Sirs, I hope you are doing fine in the new year. I would like to share my concerns about the documentation material available for packaging software for ubuntu. I am an ubuntu user since June, 2007. As I am as computer engineering student, I deal with packages of programming languages libraries frequently. Unfortunately, most of the packages available in ubuntu repositories are outdated. I know that I am using unpopular libraries and projects, and the repositories contains most of the time stable releases. I am not blaming MOTU, as this is not the place as I can file bugs against the packages I want to be updated in launchpad. As I am obessesed with ubuntu and its community efforts, I would like to participate in. I remember that there is no 3 months go without trying to package some software and add it to my personal PPA. Every time I try to do so, I face a problem reading long detailed documents and it is always failing when it comes to signing the packages. Even with the support available in the MOTU IRC channel I could not manage it correctly for once !. My problem that the documentation available for the packaging procedure is long and detailed and it is more like guideleines and policies to do MOTU standard packaging. Even with the help of the videos, there are still a lot of details addressing licensing and manauals and packaging quality topics. As a beginner, I am more concerned with doing packaging correctly first, then getting the advantage of distributing the packages I make with my other machines or friends secondly. I believe that after knowing how to package, packaging professionaly would be a matter of following the guidelines. 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. Kindest Regards. -- Rami Eid -- Ubuntu-motu mailing list Ubuntu-motu@lists.ubuntu.com Modify settings or unsubscribe at: https://lists.ubuntu.com/mailman/listinfo/ubuntu-motu