=== Pascal is now known as Guest73393
=== ChanServ changed the topic of #ubuntu-classroom to: Welcome to the Ubuntu Classroom - https://wiki.ubuntu.com/Classroom || Support in #ubuntu || Upcoming Schedule: http://is.gd/8rtIi || Questions in #ubuntu-classroom-chat || Event: Ubuntu Open Week - Current Session: Introduction to Open Week - Instructors: jose
ClassBotLogs for this session will be available at http://irclogs.ubuntu.com/2014/04/22/%23ubuntu-classroom.html following the conclusion of the session.15:00
josehello, everyone, and welcome to another edition of the Ubuntu Open Week!15:00
joseI'll just give a couple minutes so people can join us15:01
joseso, I think we're good to go :)15:02
* jose plays Jeopardy theme song15:03
josewelcome everyone to another Ubuntu Open Week15:03
josebefore we start, why don't we introduce ourselves? This channel is not-moderated only for this session so we can discuss a bit15:04
joseI'll go first: I'm Jose, and I'm from Peru (no, I don't have a llama on my backyard)15:04
skieiHi Jose, good too meet you. I am a developer from Bangalore, India. Looking to find myself a place to contribute to ubuntu/linux.15:05
josewelcome, skiei!15:06
joseanyone else is around?15:06
josehello, Me!15:06
belkinsaI'm Svetlana and I'm a Ubuntu Community Member that focuses on get people involved with Ubuntu.  I'm a part of Ubuntu Women, Ohio LoCo, LoCo Contacts, and Ubuntu Doc Team.15:07
j_f-fHi jose15:07
josehello, j_f-f!15:07
belkinsaAnd I will be giving the Ubuntu Women session tomorrow at 1500 UTC with pleia2/15:08
jincreator_Hi, all, I'm Jinkyu, university student from Korea. I'm looking for a way contribute to ubuntu by fixing bugs.15:09
joseanyone else wants to introduce themselves?15:10
joseok, let's move on, then15:11
josethis is the first session we're having for the Ubuntu Open Week, which is a series of sessions where you will be able to find your place in the Ubuntu Community15:11
josewe have been planning this so that during the week you will be able to find people from many many different teams15:12
PabloRubianesI am here too jose15:12
josehello, PabloRubianes15:12
PabloRubianeso/ all15:13
joseso whether you are a developer, designer, or a community member you will be able to see a lot of areas where you can contribute15:13
josewe're go through some of the basics around the sessions15:14
josefirst of all, how to ask questions15:15
joseif you want to ask any questions, you need to type the word QUESTION: before your actual question15:16
joseas an example: "QUESTION: How do I do this?"15:17
josego ahead, and try it if you want15:17
jose(that should be done in #ubuntu-classroom-chat)15:17
ClassBotjincreator_ asked: How do I do this?15:18
josewell, by doing that, for sure :)15:19
joseso have in mind that a instructor may choose to answers questions throughout the session or at the end15:19
ClassBottorbuntu-germany asked: How old are MArk Shuttleworth?15:20
* jose checks Wikipedia15:20
skieiQUESTION:  (n00b question) how exactly can we find a place to contribute to? i'm new to the foss community, and not too comfortable with finding tasks on my own15:20
joseskiei: remember questions are asked in #ubuntu-classroom-chat15:20
joseso, torbuntu-germany, according to Wikipedia Mark is 40 years old :)15:20
joseso, yep, that's how you can ask questions15:21
josedon't feel ignored if an instructor does not answer your questions right away, they may have chosen to leave questions for the end of the session15:22
joseor maybe for the end of the sub-topic15:22
josemany times, instructors cover what's on the questions later on in their sessions15:22
joseand as you may have discovered by now, #ubuntu-classroom (this channel) is where sessions take place15:24
joseand all chatter and questions should go in #ubuntu-classroom-chat15:24
joseduring the sessions, you will not be allowed to talk in here, it will only be restricted to the Instructor15:24
joseso moving on15:24
joseas I mentioned before, the Ubuntu Open Week is the right event if you want to get involved with the awesome community that we have15:25
josethe full schedule can be found here: https://wiki.ubuntu.com/UbuntuOpenWeek15:26
joseas an example, today we are going to have people from the Ubuntu Server Team, from the Ubuntu Documentation Project, and from the Juju Team15:26
joseall of them are going to talk to us about the different things they do on their teams15:27
joseand then they're going to explain to us what can we do to contribute to the teams15:29
joseor projects15:29
josealso, if you are not able to attend a session and want to read the logs, they will be linked to each title on the schedule as soon as we can (it's managed by humans, so things don't happen automagically)15:30
josethere is one session each day that will be done via a video livestream, and they are marked with the [ON AIR!] tag on the schedule15:31
joseyou will be able to watch the video at ubuntuonair.com, and the channel for discussion is still going to be #ubuntu-classroom-chat15:31
joseand if you by chance miss the video stream, you can watch it at any time later by going to youtube.com/ubuntuonair15:32
ClassBotj_f-f226627 asked: I'm a software Developer especially with C++. How can I help?15:32
joseI think I can not give a direct answer to that question right now, but if you find a session that interests you just make sure to be around15:33
joseI can suggest the Ubuntu Development Team session, which is taking place on the 24th April at 15 UTC15:33
ClassBotDS_McGuire_ asked: I am (in my spare time) a web developer, I study HTML, CSS and JavaScript mostly. Is there anyway I can help?15:35
joseDS_McGuire_: for you, I can recommend the Ubuntu Websites and App Development sessions15:35
josebut as I mentioned earlier, each of you can mark the session that interests you the most and attend it15:35
joseif you check the schedule, all times for sessions are set on UTC15:38
joseso make sure to convert the time correctly to see at what time the session you want to attend is, so you don't miss it15:39
josewe suggest using timeanddate.com to convert times, or you can click on the time of the event on the schedule15:39
josethese will be updated daily so you don't get an error saying that the event has passed :)15:40
joseso, I don't know if you guys have any questions about the event itself?15:40
ClassBottorbuntu-germany asked: Have the UbuntuOpenWeek Sessions Slides?15:47
josenope, this time OpenWeek sessions will not have slides :(15:48
ClassBotjincreator_ asked: Is Ubuntu Open Week runs regularly? If then, when is next Ubuntu Open Week?15:48
josewe try to run them regularly, each cycle that is15:48
joseusually the first week after release, so...15:48
joseI think the release calendar for the next release hasn't been set yet, so we'll have to wait for that :)15:49
ClassBotThere are 10 minutes remaining in the current session.15:50
ClassBottorbuntu-germany asked: After every Release? Ore LTS Release only?15:50
josewe try to do them after every release, but sometimes it's a bit hard to organize this kind of events15:50
josebut they are always announced in ubuntuclassroom.wordpress.com, which is our team's blog :)15:51
josebefore we end this session, I want to thank everyone who is contributing to Open Week :)15:52
josethanks to all of our instructors, to pleia2 for managing some of the sessions, and to Sam Hewitt for the new OpenWeek logo we're featuring this time!15:52
josenext up, in a bit less than 7 minutes, we have a session about the Ubuntu Server Team with beisner15:53
joseso go grab a cup of coffee, sone snacks, and we'll be back by then15:53
joseI hope you enjoy the rest of the OpenWeek, see you all around!15:53
ClassBotThere are 5 minutes remaining in the current session.15:55
=== ChanServ changed the topic of #ubuntu-classroom to: Welcome to the Ubuntu Classroom - https://wiki.ubuntu.com/Classroom || Support in #ubuntu || Upcoming Schedule: http://is.gd/8rtIi || Questions in #ubuntu-classroom-chat || Event: Ubuntu Open Week - Current Session: Ubuntu Server Team - Instructors: beisner
gaughenbeisner, I'm here!16:00
ClassBotLogs for this session will be available at http://irclogs.ubuntu.com/2014/04/22/%23ubuntu-classroom.html following the conclusion of the session.16:00
beisnerhi, gaughen!  o/16:01
beisnerGreetings all!16:01
beisnerWe'll wait another minute or so for folks to join.16:02
beisnerAgain, welcome to Ubuntu Open Week!  https://wiki.ubuntu.com/UbuntuOpenWeek16:02
beisnerThank you for joining us.16:03
beisnerA brief intro...16:03
beisnerMy name is Ryan Beisner, I am a Quality Assurance Engineer on the Server Team at Canonical.16:03
beisnerIn other worlds, such as twitter and launchpad, I am 1chb1n.16:03
beisnerFor the first bit of our session, we also have the Ubuntu Server & Openstack Team manager, Pat Gaughen (irc: gaughen) with us today.16:03
beisnerThank you for joining, gaughen!  :)16:04
beisnerFeel free to ping us later on irc or g+ for follow-up questions, etc.16:04
beisnerok, so16:04
beisnerFirst, I want to thank Jose & crew for arranging the Ubuntu Open Week sessions.  Your community rally is most appreciated!16:04
beisnerAnd a great big THANK YOU to the community members who support and promote Ubuntu!16:04
beisnerWe are fortunate to have a very strong community, with continually growing interest.16:04
beisnerThe general purpose of Ubuntu OpenWeek is to provide information and answer questions about getting involved with the Ubuntu community.16:05
beisnerThis Server segment of OpenWeek is all about how you can get involved in one of the most exciting things happening right now:16:05
beisneradoption of open source in the enterprise, and more specifically, the continued proliferation of Ubuntu Server in the cloud space.16:05
beisnerTogether, let's be a part of producing the awesome Ubuntu Server platform - which is in use today by many businesses and organizations of all sizes.16:05
beisnerYou don't have to be a seasoned programmer, devops wizard or architect of clouds.16:06
beisnerAlthough, if you are, we certainly welcome your involvement!16:06
* beisner waves to the classroom-chat16:06
beisnerGlad to see so many folks present!16:07
beisnero/  :)16:07
beisnerAnd so, super ninja programming skills are not necessarily required to help out.16:07
beisnerThe daily (day-job) work that many system admins do while working with and deploying Ubuntu is actually quite ideal for involvement here.16:07
beisnerSo, we want to encourage you to explore the many areas ... and find a place to get involved.16:08
beisner...At any time, please feel free to ask questions.16:08
beisnerAs a reminder, please post your questions in #ubuntu-classroom-chat in the following format:16:08
beisnerQUESTION: How are you today?16:08
beisnerI'd like to post some Server Team links for your reference, then we'll jump into a few things.16:09
beisnerThe Server team’s site:  https://wiki.ubuntu.com/ServerTeam/16:09
beisnerThe Server Team blog:  http://www.ubuntuserver.org16:09
beisnerIt’s also worth keeping an eye on http://planet.ubuntu.com16:09
beisnerYou can download current and past releases of Ubuntu Server here: http://releases.ubuntu.com/16:09
beisnerAnd hot of the press...16:10
beisnerThe official Ubuntu Server Guide (14.04 Trusty Tahr):  https://help.ubuntu.com/14.04/serverguide/index.html16:10
beisnerNow, a quick overview of the stuff we do & the things we care for.16:11
beisnerNaturally, the 'traditional' suite of server packages are critical to a solid enterprise-grade server release.16:11
beisnerApache, samba, bind, dhcpd, mysql, postgres, et al, are all mature projects.16:11
beisnerBut even those good ol' staples continue to develop and progress.16:11
beisnerThe complete list of packages that the server team looks after can be found on the wiki:  https://bugs.launchpad.net/~ubuntu-server/+packagebugs16:12
beisnerOn a high level, perhaps some of the most notable undertakings of the server team are:  Openstack, MAAS, LXC (linux containers), uvtool, cloud-init, Ubuntu cloudimages ...16:12
beisnerSee the ServerTeam Wiki for more detail of course.16:12
beisnerThat encompasses and overlaps with other areas of focus such as JuJu charms for automating Openstack deployments (!).16:13
beisner(Pretty cool stuff right there!)16:13
beisnerARM architecture is also a biggie.  Most other distros aren't there yet.16:13
beisnerIf you are specifically interested in being involved in any of these other areas, ping us on freenode irc #ubuntu-server.16:14
beisnero/ hi rbasak16:14
beisnerAny one of these products could dovetail into a full session, so we won't detail those now.16:14
beisnerIf there are specific questions, fire away!  Remember to preface all of your questions with  QUESTION:16:14
beisnerNext I'd like to touch on the release cycle.16:15
beisnerhttps://wiki.ubuntu.com/Releases  shows the current and past releases16:16
beisnerAs well as their lifecycles.16:16
beisnerI'd say most Server deployments stick to the LTS releases in production environments.16:16
beisnerThe 5-year lifecycle is attractive to sysadmins and desktop users alike.16:17
beisnerBut the interim releases are also very important as they are where we break new ground.16:17
beisnerFYI Long-Term Support info:  https://wiki.ubuntu.com/LTS16:17
beisnerFor the dev folks out there, one way that you may be able to contribute is with SRUs.16:18
beisnerIf you are a software developer, there are ongoing tasks like Stable Release Updates (SRUs) and backports ... preparing debdiffs, performing verification, etc., may be right up your alley.16:18
beisnerThe SRU page:  https://wiki.ubuntu.com/StableReleaseUpdates16:18
beisnerAnd the more advanced & involved front, for those who love devops (including puppet/chef/ansible/salt only shops):16:19
beisnerWe'd love to see you run your own deployment tests against both stable -proposed pockets and against the current development release, detecting regressions, filing bugs, and reporting success.16:19
beisnerAgain, freenode irc #ubuntu-server is the place to ping us if you are interested in these types of involvement.16:20
beisnerAnd now, other ways to get involved with Ubuntu Server...16:20
beisnerWe recognize that not everyone is a software engineer.  That's ok!16:21
beisnerThere are a lot of ways to contribute which don't necessarily involve coding.16:21
beisnerSpecifically, the GettingInvolved page is a good resource:  https://wiki.ubuntu.com/ServerTeam/GettingInvolved16:21
beisnerThere are other areas, such as documentation, web page, wiki, irc support, and more.  Later OpenWeek sessions will provide info on those valuable efforts of contribution as well.16:22
beisnerLet's talk a bit about server ISO testing.16:22
beisnerThis is something everyone can do.16:22
beisnerWell, this piece really applies to Server and Desktop.16:23
beisnerI think that sometimes folks may run into an issue while installing a system via ISO, and find their own workaround, then move along to resuming their initial mission of bringing up a new box for a particular purpose.16:23
beisnerWhile we do have a lot of automated testing in place, I think it's also essential to have a good test base of the ISO16:24
beisnerbuilds.  Sometimes this manual ISO testing can reveal issues with scenarios that the automated testing may not.16:24
beisnerAnd so ...16:24
beisnerThis is a call out to the community to help the server team by participating in periodic server ISO testing. :)16:24
beisnerThe QA Tracker page is where you can learn more about ISO testing:  http://iso.qa.ubuntu.com/16:25
beisnerYou can run the current (or past) ISO builds against pre-defined test cases, then report your results in the QA Tracker.16:25
beisnerMost of these tests can be performed in a VM - on KVM, qemu, virtualbox, vmware, etc., or on bare metal hardware.16:26
beisnerAny bugs discovered and filed can be referenced, linking the Launchpad bug to the QA Tracker results.16:27
beisnerAnyone who is interested in participating can get started at http://iso.qa.ubuntu.com/.16:28
beisnerYour involvement on this front is very much appreciated!  Well, on all fronts, really! ;)16:28
beisnerAnd I'd like to reiterate -16:29
beisnerFor those deploying Ubuntu Server and the related packages in your day-to-day work:  You are in a *great* position to be able to contribute to the Ubuntu community.16:29
* beisner is out of breath.16:29
beisnerQuestions, good!16:29
ClassBotPaulW2U asked: I only have laptop hardware available at present. Is ISO testing on laptops useful?16:29
beisner+1 rbasak - most of the server iso testing is hardware-independent.16:30
beisnerPaulW2U ^^16:30
beisnerMy suggestion would be to use KVM or virtualbox to spin up the ISO and run through the test cases.16:30
beisnerUnless you're ok with paving the laptop altogether to install natively, which is also a good test.16:31
beisner!QUESTION / !Q16:32
beisnerOk I can make servers do all sorts of cool things, but not ClassBot apparently.  ;)16:32
ClassBotjincreator_ asked: Is iso testing automated, or run by humans(volunteers)?16:33
* beisner thanks Jose16:33
beisnerjincreator_:  There are some automated ISO tests, but not all of the testcases on the QA Tracker are currently automated.16:33
beisnerWe are working on automating more of them, however.16:34
beisnerThe broader server hardware base in the community at large is also something that is difficult to reproduce in a lab.16:34
beisner(Although we do test on quite a wide range of hardware.)16:34
beisnerGood questions.  Thank you.16:35
beisnerAre there any more questions about ISO testing?  Or anything else so far?16:36
ClassBotjincreator_ asked: Where can I see the automated ISO testing code?16:36
beisnerjincreator_:  I'm not sure if there is currently a public resource specific to iso automation, other than the individual pieces that one can use to make it happen.16:38
beisnerSuch as...  preseeding:  https://help.ubuntu.com/14.04/installation-guide/amd64/apb.html16:39
beisnerAnd UTAH:  http://utah.readthedocs.org/en/latest/index.html16:39
beisnerThat could be a great area to get involved, and I'd invite you to ping us on that.16:40
beisnerAnother great question!16:40
beisnerShall we jump into some of the basics of bug filing?16:41
beisnerI'm not going to dive too deep, but I do want to provide some information and guidance.16:41
beisnerI think it's safe to say that the health and stability of any open source ecosystem relies on bug reports, and the quality/completeness of those reports.16:42
beisnerOne of my favs:16:42
beisner"A problem well stated is a problem half-solved." -Charles Kettering16:42
beisnerBy contrast, "a problem unreported is pretty difficult to solve."  -Me  =)16:43
beisnerIf you're experience an issue, I'd say first search launchpad for an existing bug.16:43
beisnerIf there is indeed an existing bug, and you can provide additional diags, insight or info, please do so.16:43
beisnerThis may help to triage the bug.16:44
beisnerBut if you find that the problem, supported by research of support, lists, irc, manpages, docs, etc., is unexpected behavior:  please do file a bug.16:44
beisnerSome folks may be apprehensive about filing bugs ... but there is no shame in ending up with a NotABug or Invalid.16:45
beisnerHere are some good resources on reporting bugs:16:45
beisnerReporting bugs in Ubuntu Server:  https://help.ubuntu.com/14.04/serverguide/reporting-bugs.html16:45
beisnerGeneral info and instructions regarding Bug Filing:  https://wiki.ubuntu.com/Bugs/16:46
beisnerGeneral bug filing guidelines:  https://help.ubuntu.com/community/ReportingBugs16:46
beisnerPlug:  For more detail about QA-centric activities and the Quality Team, I invite you to join balloons right here on Wed 23 Apr @ 1800UTC.16:47
beisnerAre there any questions before we move on?16:47
beisnerMoving on - are there any LUG nuts in the house? \o/16:48
beisnerThere are many local and regional Linux User Groups out there - and some of them focus on Linux server use.16:48
beisnerWe are definitely interested in participating in these types of groups and events.16:49
beisnerAs you probably know, we have team members all across the US and around the world.16:49
beisnerWhether it's Q&A about Ubuntu Server, general banter or a more official presentation or demo...16:50
beisnerPlease let your LUG know that we also want to be a part of your community.16:50
ClassBotThere are 10 minutes remaining in the current session.16:50
beisnerIn-person meet ups, virtual hangouts, and ongoing participation, etc.16:50
beisnerWho knows, it may even involve pizza!16:50
beisnerFeel free to reach out on #ubuntu-server or ping me, gaughen or any of the Ubuntu Server Team.16:51
beisnerI want to make sure we leave time to address any other questions out there.16:52
beisnerOk, no ?s at the moment.16:53
beisnerWrapping up -16:53
beisnerYou, the community are a very important partner in keeping Ubuntu Server a very high-quality platform of choice.16:53
beisnerOn behalf of the Ubuntu Server Team:  one more THANKS for your support of this awesome distro.16:54
beisnerThank you for joining us for this session from the Ubuntu Server team.16:55
beisnerIRC:  #ubuntu-server16:55
beisnerWiki:  https://wiki.ubuntu.com/ServerTeam16:55
ClassBotThere are 5 minutes remaining in the current session.16:55
beisnerAnd now, I'd like to wrap up with a shameless recruit plug!16:55
beisnerCanonical is always looking for the best minds to join us in bringing Ubuntu to the world.16:55
beisnerWe have just a few minutes left for questions.16:56
beisnerThanks again for attending Ubuntu OpenWeek!16:57
beisnerCheck out https://wiki.ubuntu.com/UbuntuOpenWeek for the full schedule and other useful links.16:57
beisnerBye all.  See you around!16:59
=== ChanServ changed the topic of #ubuntu-classroom to: Welcome to the Ubuntu Classroom - https://wiki.ubuntu.com/Classroom || Support in #ubuntu || Upcoming Schedule: http://is.gd/8rtIi || Questions in #ubuntu-classroom-chat || Event: Ubuntu Open Week - Current Session: Ubuntu Documentation Team - Instructors: pleia2
ClassBotLogs for this session will be available at http://irclogs.ubuntu.com/2014/04/22/%23ubuntu-classroom.html following the conclusion of the session.17:00
pleia2hi everyone!17:00
pleia2quick reminder, if you have any questions during the session please ask them in #ubuntu-classroom-chat with the prefix QUESTION: so the bot can pick it up17:01
pleia2my name is Elizabeth K. Joseph and I'm a member of the Ubuntu Documentation team17:01
pleia2today I'm here to give an overview of the places where you can get involved with documentation in the Ubuntu community17:01
pleia2so let's dive right in :)17:02
pleia2first up, we have the Desktop Documentation17:02
pleia2the Desktop docs are shipped on every Ubuntu Desktop install, they're what you'll find when you search for help on your desktop17:02
pleia2they're also published to help.ubuntu.com, so the latest official desktop docs can be found here: https://help.ubuntu.com/14.04/ubuntu-help/index.html17:02
pleia2this makes them pretty important to get right, and since everyone who works on documentation in Ubuntu is an unpaid volunteer, we could always use the help with all aspects17:03
pleia2additionally, the team commits to updating this documentation every cycle, so this means that careful review of the full documentation is done every 6 months and updated based on changes, new features, etc in the release17:04
pleia2on the technical side, the documentation is written in a markup language called "Mallard" (the same as what GNOME uses)17:04
pleia2you can learn more about Mallard here: http://projectmallard.org/17:04
pleia2the source for the documentation can be found at lp:ubuntu-docs which can be accessed via the revision control system bazaar (bzr)17:05
pleia2a step by step walkthrough of how to contribute can be found here: https://wiki.ubuntu.com/DocumentationTeam/SystemDocumentation/UbuntuDesktopGuide17:05
pleia2this includes the packages you need to install, some tips for editing documents and how to actually submit your changes via bzr for review17:05
pleia2all changes made to the desktop guide are reviewd by an admin on the documentation team before being committed17:06
pleia2any questions about Ubuntu desktop documentation?17:06
pleia2ok, if you think of any, feel free to ask at any time :)17:07
pleia2next up we have Server Documentation17:07
pleia2this documentation is specific to servers running Ubuntu and is separate from the desktop documentation17:07
pleia2unlike the Desktop documentation, this team is now only committed to releasing a new guide for each LTS release, so every 2 years (with "occasional" updates made available between LTSs)17:08
pleia2this is because most folks who are running servers are only interested in the LTS versions for their servers (I admit, this is what I do too)17:08
pleia2server docs are not shipped with installed versions of Ubuntu server and instead are only published on help.ubuntu.com17:09
pleia2they're available there as html and pdf as you can see in the latest release here: https://help.ubuntu.com/14.04/index.html17:09
pleia2also unlike the desktop docs, these docs are written in DocBook (not Mallard), and the source is also available via bzr at lp:serverguide17:09
pleia2DocBook is a pretty standard tool for writing documentation in open source projects, so many folks are already familiar with it, but if you've never used it you can learn more at http://www.docbook.org/17:10
pleia2the step by step walkthrough of how to contribute to server documentation is available here: https://wiki.ubuntu.com/DocumentationTeam/SystemDocumentation/UbuntuServerGuide17:11
pleia2again, like the desktop guide this tells you what you need installed, how to submit revisions, etc17:12
ClassBotknome asked: Why is there two different ways of writing documentation. Shouldn't it be standardized?17:12
pleia2it's actually a question from captine, good question!17:12
pleia2once upon a time, both sets of documentation were written in DocBook17:13
pleia2then the GNOME project switched to using Mallard, and since the Ubuntu documentation drew heavily from their documentation the desktop team decided to switch to Mallard so they wouldn't need to rewrite all the markup17:13
pleia2there isn't actually a whole lot of overlap between Desktop and Server documentation folks, so it hasn't mattered much, and the server team is even talking about switching to something else entirely too17:14
pleia2now, beyond these "official" documentation types in the core Docuemtation team, we also have docuementation that's maintained on the wiki17:15
pleia2everything prefixed with /community on help.ubuntu.com is actually a wiki, so starting here: https://help.ubuntu.com/community17:15
pleia2this can be edited by anyone in the community, at any time, and there are no set deadlines or freezes for when it should be completed17:16
pleia2as such, it's a much more "living" document that the community maintains, and while there is a team to keep an eye on things (and we need help here), it's not strictly updated every cycle like other forms of documentation17:16
pleia2it also means you will often find outdated pages and ones that only work with specific versions of Ubuntu, but there is still a lot of valuable information on the wiki17:17
pleia2it's also not shipped with Ubuntu or anything, so it's more of an online reference17:17
pleia2to get started working with this, all you need is a web browser and a launchpad account :) if you have any account trouble, we put together this page: https://help.ubuntu.com/community/WikiGuide/Registration17:17
pleia2there are sometimes sync up issues between ubuntu single sign on and launchpad when it comes to logging into the wiki, making it so even when you can log in you still can't edit17:17
pleia2I have a ticket open with Canonical about this, so hopefully it won't last forever, since it does confuse newcomers17:18
pleia2once you're able to log in and edit pages, see here for actually getting started: https://wiki.ubuntu.com/DocumentationTeam/Wiki17:18
pleia2wiki syntax is easier to learn than DocBook or Mallard, so a lot of folks enjoy starting here17:19
ClassBotcaptine asked: I assume when you say there are some people overseeing the wiki docs, you mean there is some sort of review prior to the update being applied?17:19
pleia2not prior to, and sometimes no formal review ever, I'll get to that in a moment17:19
pleia2it's got a lower barrier to entry than the official docs that are shipped since there is little formal review process for changes (people may subscribe to certain pages to keep an eye on them, but they don't approve your changes)17:20
pleia2the wiki also allows you to create new articles for things that aren't documented, and improve existing documents immediately when you find errors17:20
pleia2the team really likes leveraging the wiki for extended documentation rather than adding the maintenance burden to the official docs (which I mentioned, we commit to updating every cycle)17:21
pleia2we also use a tagging system on the wiki to help newcomers find things to work on, you can browse all the tags here: https://help.ubuntu.com/community/Tag17:22
pleia2these tags allow you to quickly find pages that people have marked as needing content cleanup, expansion or contraction, updating for new releases and more17:22
pleia2any questions about the help wiki?17:23
pleia2I also want to mention that the Ubuntu community also has wiki.ubuntu.com - which is not for user documentation, this tends to be confusing for a lot of people17:23
pleia2it's actually a teams wiki that should be used by community members for project coordination and how-tos related to getting involved with their projects17:24
ClassBotknome asked: Should I ask somebody if i can make an edit or just go for it?17:24
pleia2you should just go for it :)17:24
pleia2if the page has someone who is gardening it, they will keep an eye on changes, in general wikis work pretty well because there is this peer review and most people mean well when they edit17:25
pleia2I haven't yet seen an edit war on a community help page, and if there ever is an issue it can be discussed on our mailing list: https://lists.ubuntu.com/mailman/listinfo/ubuntu-doc or on irc in #ubuntu-doc17:25
pleia2alright, that's the wiki!17:27
pleia2finally, there's also the Ubuntu Manual project17:27
pleia2they're not strictly part of the Documenation team, but we have some staff overlap and we all pretty much work together17:28
pleia2the work the Ubuntu Manual does is to present a low-cost (or free pdf) printable Ubuntu book for users, their site is at http://ubuntu-manual.org/17:28
pleia2it's structured differently than the official desktop documentation because it's in book form, but the manual covers similar topics17:29
pleia2and like for the desktop guide, the manual team has also been committed to releasing every cycle17:29
pleia2the Manual is written in LaTeX markup (rather than Mallard or Docbook) and then exported to pdf and to online book print shops in whatever format they require17:30
pleia2they selected this because it can be a bit easier to edit once the general structure is in place than the other two options17:30
pleia2but they also use bzr to track the source for these documents17:31
pleia2the source is here: lp:ubuntu-manual and this page describes how to get it: http://ubuntu-manual.org/getinvolved/authors#download-code17:32
ClassBotDS_McGuire_ asked: I have just had a look around https://help.ubuntu.com/community/UbuntuEyeCandy for example. Most of it (if not all of it is out of date). Who's responsibility is it to keep these updated? Ours or Canonical's?17:32
pleia2Canonical doesn't pay anyone to work on any of this documentation, so it's all a community effort and our responsibility17:33
pleia2I imagine you'll find a lot of pages like that on the wiki, we really need a volunteers to help out :)17:33
pleia2the notes on the top are the Tags I mentioned, which means that we know that it's outdated and are just waiting for someone to help clean it up17:34
ClassBotcaptine asked: If not available, could a dashboard be created that pulls the wiki page and orders it by last updated date?  This could help the community to focus some efforts on pages that are likely to be outdated?17:34
pleia2massive searches like that are really hard because it's a large wiki and it often times out when you try to do such queries17:35
pleia2but it's certainly something that can be discussed with the team to help make it easier for folks to contribute17:35
pleia2so, back to Ubuntu Manual17:36
pleia2one of the things the Manual team did early on was work to make it as easy as possible for contributors can help out, as you can see from their nice, clean get involved page: http://ubuntu-manual.org/getinvolved17:36
pleia2they define different roles for what folks may be interested, from writing to proof reading17:37
pleia2they also put a lot of effort into translations and having good design, so they need those folks too :)17:37
pleia2so that's all the documentation that's focused on Ubuntu specifically - it's a lot! and we have a pretty small team for all of these, and we're friendly, so please come chat with us or join our mailing list if you want to help out17:38
pleia2beyond that, some of the flavors of Ubuntu maintain their own documentation too17:38
pleia2Xubuntu, for instance, has documentation that's written in DocBook and also lives on launchpad at lp:xubuntu-docs17:39
pleia2these documentation teams run pretty independently from Ubuntu, so they can choose their tools, timeline (each cycle, only for LTS) and publishing mechanisms (ship with desktop, or just publish somewhere online)17:39
ClassBotknome asked: where can i chat with you?17:39
pleia2we have a mailing list: https://lists.ubuntu.com/mailman/listinfo/ubuntu-doc or on irc in #ubuntu-doc17:40
pleia2if it's related to the manual, they have #ubuntu-manual and a mailing list associated with their launchpad team: https://launchpad.net/ubuntu-manual17:41
pleia2back to flavors, for Xubuntu for instance the documentation is published on http://docs.xubuntu.org/ and shipped with each release17:42
pleia2other flavors may either rely upon upstream (lubuntu uses lxde documentation), or have minimal documentation for specific tasks either on the wiki or on their website, like Edubuntu: https://edubuntu.org/documentation17:42
pleia2so participating in upstream documentation (documenation for GNOME, Xfce, lxde) is highly recommended as well as they also rely heavily (or exclusvely) on volunteers, so documentation everywhere always needs help from the community :)17:43
pleia2or any of the default applications used in Ubuntu, documentation for LibreOffice, Firefox, all of this gets shipped with Ubuntu17:43
pleia2and that's pretty much all I had! any more questins?17:44
ClassBotThere are 10 minutes remaining in the current session.17:50
ClassBotcaptine asked: Will a stream be created for touch documentation?  Esp for installing it on hardware that it doesnt ship on by default etc17:53
pleia2so afaik currently the only documentation is developer-oriented and lives over on the other wiki: https://wiki.ubuntu.com/Touch17:53
pleia2there haven't been any efforts to work with the documentation team on further documentation, so I'm not sure what the plans are17:54
ClassBotThere are 5 minutes remaining in the current session.17:55
=== ChanServ changed the topic of #ubuntu-classroom to: Welcome to the Ubuntu Classroom - https://wiki.ubuntu.com/Classroom || Support in #ubuntu || Upcoming Schedule: http://is.gd/8rtIi || Questions in #ubuntu-classroom-chat || Event: Ubuntu Open Week - Current Session: [ON AIR] Getting Acquainted with the Juju Review Queue and Process - Instructors: lazyPower
josethanks pleia2! next session will be livestreamed at ubuntuonair.com, and questions will go at #ubuntu-classroom-chat as usual :)18:00
ClassBotLogs for this session will be available at http://irclogs.ubuntu.com/2014/04/22/%23ubuntu-classroom.html following the conclusion of the session.18:00
ClassBotThere are 10 minutes remaining in the current session.18:50
ClassBotThere are 5 minutes remaining in the current session.18:55
=== ChanServ changed the topic of #ubuntu-classroom to: Welcome to the Ubuntu Classroom - https://wiki.ubuntu.com/Classroom || Support in #ubuntu || Upcoming Schedule: http://is.gd/8rtIi || Questions in #ubuntu-classroom-chat || No Sessions Currently in Progress

Generated by irclog2html.py 2.7 by Marius Gedminas - find it at mg.pov.lt!