<> === Session Logs === {{{#!IRC [01:01] Now we have ddecator joining us to talk about Launchpad :) [01:01] Draycen DeCator is a member of the Ubuntu BugControl and Ubuntu Beginners teams. He is a Psychology student at DePaul University in Chicago. His session will cover how users can effectively use the Launchpad site, especially with regards to the Ubuntu project. Draycen is often found on IRC and is always willing to answer questions. [01:01] Hello everyone, and welcome to the "Using Launchpad" session! [01:02] pleia2 was kind enough to already explain how to ask questions :) [01:02] Rather than go into extreme detail for each section, I will be giving a summary of each resource Launchpad provides, then I'll be open to questions after each section and at the end of the session [01:03] This session also has a corresponding slideshow for those of you using Lernid (which should be displaying already since ClassBot provided the URL) [01:03] If you are not using Lernid, then you will only miss out on screenshots of certain Launchpad pages. These screenshots can help you understand what I am talking about, but you can follow along in any IRC client and still be fine. You can also download the slideshow using the provided link and follow along manually [01:04] Finally, I recommend you login to Launchpad.net now (or create an account if you need to) at this time. I will try to go fairly slow so you can see what I'm talking about on the site for you hands-on learners :) [01:04] Alright, with that out of the way, let's begin! [01:04] [SLIDE 1] [01:04] Launchpad is a site dedicated to helping projects be successful. In order to do so, the site offers many of the services needed by project leaders [01:05] The site can be used for free if the project is open-source, or for a fee if the project is closed-source [01:05] That being said, we're hear to learn users can actually use the site! [01:05] learn how users* [01:06] [SLIDE 2] [01:06] The main areas of Launchpad are Project Overviews, Code hosting, Bug tracking, Blueprints, Translations, and Answers [01:06] We will cover each of these areas one at a time, starting with... [01:06] [SLIDE 3] [01:06] Project Overiews! [01:07] Every project on Launchpad gets an overview page where the owners/maintainers can provide a description of the project, link to webpages related to the project, and link to the Launchpad tools the project uses [01:07] Project leaders must enable each of Launchpad's services if they want to use them. As a result, some projects just have an overview page that links to their bug tracker and website. [01:08] Even if that's the case, the overview page is a great resource for users who want to learn more about a project, or package, and how they can get involved [01:09] [SLIDE 4] [01:09] Here is the Ubuntu project's overview page [01:09] In the picture, I have added red arrows pointing out how you can reach the other areas of Launchpad used by the project [01:09] For example, clicking on "Bugs" will bring you to a page listing all of the reported bugs related to Ubuntu [01:10] The links on the right, under "Get Involved," can be used if you want to help with the project, and they are fairly self-explanatory [01:10] For example, if you click "Ask a question," you will be brought to a page where you can fill out a question and add it to the Answers section (which we will cover later in the session) [01:11] The overview page also gives information on versions of the project that have been released, what version is the current development focus, who owns the project, and who the top contributors to the project are [01:11] OK, are there any questions at this point? [01:13] Great! Now that everyone is on the same page, lets go through each section listed on the overview page in order [01:13] [SLIDE 5] [01:13] First up is the "Code" section [01:13] If you go to a project's code section, you can see what "branches" of code are hosted for the project on Launchpad [01:14] Code branches are basically directories that contain code needed by projects. Usually there is one branch for each version/release of the software. [01:15] These branches are created and manipulated using the Bazaar (bzr) tool [01:15] Using bzr, users can easily pull (download) code from Launchpad, view/manipulate the code, and push (upload) the code back to Launchpad [01:16] For more info on how to use bzr, you can run "bzr --help" in a terminal (if you have bzr installed) [01:16] Launchpad also uses Loggerhead, which allows users to view a branch's contents from their web browser [01:16] [SLIDE 6] [01:16] Loggerhead is a great tool if you want to see what files and directories are in a branch, or if you want to view the contents of a file in a branch without having to download everything [01:17] To use Loggerhead, you can go to a project's code page, click the branch you want to view (such as "lp:firefox"), then on the branch's page you can click the "View the branch content" link, which will bring you to Loggerhead [01:18] Using Loggerhead, you can click through directories and files and view their contents [01:18] You may also notice that on a branch's page you can see the latest revisions near the bottom of the page [01:18] Clicking "All revisions" will bring you to a Loggerhead page that shows you all of the revisions made to the branch, along with the description given by the person who made the change, and a list of what files were changed [01:19] This tool is very helpful if you want to see when a certain change was made, who made the change, and/or how the change was made [01:19] Alright, is everybody still with me? Any questions? [01:20] [SLIDE 7] [01:21] Bugs is a commonly used area of Launchpad [01:21] Users who run into a bug in a program can use Launchpad's bug tracker to let the developers know about the issue so they can fix it (if the project has decided to use Launchpad's bug tracker instead of their own) [01:21] If you go to a project or package's bug page, you can see what bugs are open, and you can search by keyword, status, etc. [01:22] For Ubuntu, if you run into an issue with a program you should file a bug against the package if possible instead of the "upstream" project. Sometimes bugs are due to a patch applied just on Ubuntu, or a mistake with the packaging. If the bug needs to be handled by the developers, then we can forward reports upstream [01:22] If you have a bug, you can use Launchpad to search the current bug reports to see if it has been reported already [01:23] [SLIDE 8] [01:23] In the event that you find a bug report for your issue, you can mark the bug as affecting you by clicking the "This bug affects # people. Does this bug affect you?" link. Marking a bug as affecting you helps developers see what bugs are affecting the most users, and thus need a higher priority [01:23] You can also subscribe to a bug report using the "Subscribe" link on the right side of the report's page [01:24] If you do not find a report for the bug you are experiencing, you can click "Report a bug" on a project's overview page or, for Ubuntu, run "ubuntu-bug " in a terminal (which adds debugging info to the report automatically) [01:24] Either option will bring you to a Launchpad page where you can fill in the details about the bug and attach files such as logs or patches [01:25] After a bug is reported, a triager will hopefully find your report and help make sure there is enough info for the developers. If you reported a bug or are subscribed to a bug, you will receive emails for new comments and changes to the report so you will know if more information is requested [01:25] A quick note: If you find a report for a bug you are experiencing, feel free to add a comment if you can add new information, but please avoid leaving comments that just say "I have this too" since that does not help much :) [01:26] On Ubuntu, bug triage is largely handled by the BugSquad. Users who want to help with bug triage can learn more at the BugSquad's wiki page: https://wiki.ubuntu.com/BugSquad [01:26] OK, any questions about the bugs section? [01:27] suprengr asked: not the point in hand [except bugs=karma] but doesn't the "karma"points system smell a bit of class/caste descrimination? [01:27] Good question, karma is something a lot of users wonder about [01:28] In reality, karma means nothing. Karma points are given to "reward" users for helping out, but some of the most involved developers only have a few hundred karma points [01:29] Having more or less karma than someone else in no way makes you better or worse, and community members know this :) [01:29] Any other questions before we move on? [01:30] Real quick: If you want more info on how karma is determined, you can go here: https://help.launchpad.net/YourAccount/Karma [01:31] Alright, moving on [01:31] [SLIDE 9] [01:31] The Blueprints section is more helpful for project maintainers than users, but some users may find them handy [01:31] Blueprints are a way for project maintainers to keep track of what their plans are for a project, and they can mark things done as they go along [01:32] Users who want to see what is planned for the future of a project can look to see if the project has any blueprints hosted on Launchpad [01:32] You are even able to subscribe to blueprints so you will get emails whenever the blueprint is updated [01:32] Since blueprints are more for project maintainers than users, I don't have much more to talk about [01:33] Any quick questions about blueprints before we move on? [01:35] [SLIDE 10] [01:35] A very nice and useful area of Launchpad is Translations [01:35] Most programs are written in English, so they need to be translated for non-English speakers to effectively use them [01:35] Users are able to see how much of a project is translated via the Translations area [01:36] [SLIDE 11] [01:36] The Ubuntu Translations page shows a progress bar next to each language which tells you how much of the project has been translated to that language [01:36] Users who are fluent in a non-English language are more than welcome to help out with translating Ubuntu [01:36] From the Ubuntu Translations page, you can click your language, then see what packages need translating into your language [01:37] If you find a package that has red in the progress bar (meaning it has strings (sentences) that are untranslated), then you can click that package and you will be brought to a screen where you can translate different strings [01:37] Launchpad will also show you some current translations so you can review them and suggest a new translation if you feel it can be improved [01:38] When you first go to translate, Launchpad will ask you to license your translations under the BSD license so projects can use your translations, so please do so if you want your translations to be used effectively [01:38] OK, any questions about translations? [01:40] [SLIDE 12] [01:40] And finally, the last section is Answers [01:40] This section allows users to submit questions to projects and, hopefully, get an answer from a maintainer or someone familiar with the project [01:40] For Ubuntu, Answers supplements the forums and IRC [01:41] If you have a question that is specific to a project or a package, you can go to the project's page and click "Ask a question" on the right side [01:41] [SLIDE 13] [01:41] From there, you will be prompted to state your question. Launchpad will then suggest any questions that seem to be similar (just in case someone has already asked your question) [01:42] If your question has not been asked, then you can provide more details and post the question [01:42] The processes for asking a question and reporting a bug are very similar, so if you've done one then you should have no trouble doing the other [01:42] Users are also welcome to share their knowledge and help answer questions [01:43] If you go to the Answers section of a project, you will see a list of questions that have been asked [01:43] You can find a question that you can answer, click the link, then leave a comment and change the status (if appropriate) [01:43] Much like other areas of Launchpad, you can also subscribe to questions so if there are any responses you will get an email [01:43] Alright, any questions on the Answers section? [01:45] [SLIDE 14] [01:45] There are several areas where you can receive help with using Launchpad if you run into problems [01:45] On IRC, we have the #launchpad and #ubuntu-beginners-launchpad channels (both on freenode, and the latter is relatively new, so it may be quiet) [01:46] The Launchpad help site (which I have linked to throughout the slideshow) is also a great place to find detailed info on all areas of Launchpad [01:46] Finally, one of the best tools Launchpad offers is the "staging" site [01:46] https://staging.launchpad.net/ [01:46] On the staging site, you can go through menus, make changes, and get an overall feel for how the site works without any of the changes actually being made on the main site [01:46] This is great if you want to try contributing but aren't sure how the process works yet. You can go to a bug, change the status, leave a comment, and so on without fear of doing anything wrong [01:47] If you're on the staging site, you will see "demo" in the background. That way you will always know if the changes you are making will be saved or not [01:47] Alright, I think that's everything I needed to talk about! The rest of the session can be used for questions, so ask away :) [01:50] There are are 10 minutes remaining in the current session. [01:50] If you want to report a bug using ubuntu-bug and Launchpad's staging site, you can run "APPORT_STAGING=1 ubuntu-bug " [01:51] Apport is the program called when you run "ubuntu-bug" and it handles collecting debugging info from your system [01:51] rogerdg asked: If a user has found a flaw in an application and wants to report it, but the bug reports say the problem has been fixed what should the user do? [01:51] Very good question! [01:52] First, the user should make sure their software is fully up-to-date (just in case they haven't received the update that fixes the bug yet) [01:52] If it is, and the problem still persists, then there is likely a regression in the program [01:53] In this case, it is best to open a new report using ubuntu-bug, then mention the previous report and mention that it may be a regression [01:53] This is easier for developers to handle than dealing with bug reports being re-opened and getting longer and more disorganized [01:54] We have ~6 more minutes for questions :) [01:55] There are are 5 minutes remaining in the current session. [01:57] We still have a few more minutes for questions, but I just want to mention real quick that everyone is welcome to PM me on IRC if they have any questions [01:59] Ah, maco bring ups a good point. Bugs marked "Fix released" may be fixed in the development release, but not the stable. If the issue isn't security related, it may not be fixed in the stable release [01:59] Thanks maco :) [02:00] OK, thanks to everyone for attending, I'm going to pass things on to the awesome maco and pleia2! }}}