thorwilgodbyk: drive-by increasing sanity level on ayatana list, eh? ;)19:46
godbykthorwil: My feeble attempt, yes. :-)19:53
godbykI figured a quick response would generate a bashful reply, 'Oh, well, nevermind then.'  Sadly, that's not what happened.19:54
godbykHey, rickfosb. How's it going?20:00
godbykHey, c7p.20:01
c7phi godbyk20:01
rickfosbDoing great, godbyk!20:02
c7phello all :)20:02
rickfosbAnd you?20:02
godbykNot too bad.20:03
rickfosbHi c7p.   Meeting not for another hour, right?20:05
piratemurrayanother hour yup20:05
piratemurrayi thought it was now.20:06
piratemurraysilly british summer time!!20:06
issyl0I thought it was now too.20:06
issyl0But then I realised: 20:00 UTC.20:06
issyl0Oh well.  :-)20:06
issyl0I got here in time as well.  :P20:06
=== godbyk changed the topic of #ubuntu-manual to: Ubuntu Manual Project discussion | Meeting Agenda: http://pad.ubuntu-uk.org/UMP-April-Meeting | Style Guide: http://files.ubuntu-manual.org/style-guide.pdf | Website: http://ubuntu-manual.org | Launchpad: https://launchpad.net/ubuntu-manual | IRC logs: http://irclogs.ubuntu.com
godbykThat wasn't as tricky as I thought it might be. :)20:37
CrustyBarnaclemsg godbyk Question about the use of "\acronym". Not in style guide, but I see it all over the Installation chapter.20:43
godbykCrustyBarnacle: It's not in the style guide? Hmm.. I'll have to fix that.20:43
godbykCrustyBarnacle: What's your question?20:43
CrustyBarnaclemsg godbyk Not in Index, and search using find does not bring up any results for it.20:44
CrustyBarnaclemsg godbyk Using this guide: http://files.ubuntu-manual.org/style-guide.pdf20:46
rickfosbgodbyk, CrustyBarnacle, we probably need to add some verbiage on use (when to and not to use the tag)20:46
CrustyBarnaclemsg godbyk Yes. Should it be used on first occurrence of acronym only?20:47
rickfosbsounds reasonable20:47
godbykCrustyBarnacle: \acronym is a formatting command.  It formats the text in small caps.20:47
godbykCrustyBarnacle: So it should be used each time the acronym is used.20:48
monfortHello everyone. I'm new in the whole "ubuntu-manual" think, and as I can see it looks like I'm gonna have to learn about LateX...20:48
CrustyBarnaclemsg godbyk OK20:48
monfortI thought I could easily help as a chapter author but it's seems that it's gonna be more complicated than that.20:49
debayanWe are supposed to start in a short while, right?20:49
monfortit seems*20:49
godbykmonfort: Welcome!  Don't worry. The parts of LaTeX used by authors and editors is fairly easy to learn.  You can find most of the information you'll need in the style guide at <http://files.ubuntu-manual.org/style-guide.pdf>.  Feel free to ask me any questions you have along the way, too.20:49
godbykdebayan: Yes, we'll start the meeting in 10-15 minutes.20:49
rickfosbmonfort, its not that bad.20:49
debayancool godbyk20:49
godbykmonfort: Also, there are others who are willing to help with the formatting if you just want to focus on writing the content or proofreading.20:50
rickfosbmonfort, if you supply the typing, the editors can help with the format20:50
monfortWell actually I thought it was all about using Libreoffice and Scribus ...20:50
monfortAnd does learning LateX involves learning HTML ?20:51
CrustyBarnaclemsg monfort http://ubuntu-manual.org/getinvolved/authors20:53
shrinihei guys20:53
shrinihow are you doing all?20:53
shrinihai issyl020:53
monfortshrini, really great thanks !20:53
shrinimonfort: :-)20:54
shrinihappy to see you all again20:54
monfortCrustyBarnacle : Oh great I never saw that webpage ! :D20:54
issyl0monfort: No, learning LaTeX does not involve learning HTML.  LaTeX is great - I'd recommend just looking through the files in the existing bzr branches to get a general idea, and of course the style guide.20:54
godbykHey, issyl0. Thanks for your recent editing help on the maverick edition.20:55
debayanissyl0: I hope this session is being logged.20:55
monfortOkay I will do it. I won't participate to the meeting today, because I first need to learn on this. I'm gonna start tomorrow and will let you all know about my progress. ( I have to start from the basics ... ).20:56
issyl0godbyk: No worries - always happy to help - seeking to get more involved actually, hence my application for an editor position.20:56
c7phave in mind i will update the content of get involved pages today or tomorrow, i hope the new content will help you20:56
monfortJust one question : Who should I keep the email of ?20:56
CrustyBarnacleI recently started on LaTex. Not as steep a learning curve as it seems to start contributing.20:57
c7pmonfort: you can send mails to mailing list (if i understood the question right)20:57
monfortIs it the same kind of mailing list that uses dizans of e-mails per day ?20:57
monfortSeriously sometimes I can't read all of my mails from newsletters and stuff so with a mailing list ... :/20:58
rickfosbmonfort; to date, not that many emails from this list.20:58
godbykmonfort: The Ubuntu Manual mailing list is fairly low-traffic at the moment.20:58
monfortOkay then I'll subscribe !20:59
issyl0godbyk: I enjoy contributing.  :-)20:59
hannieHello to all of you20:59
issyl0Hi hannie.20:59
monfortI have to go now. Really happy to know you all guys and hope to be able to help as soon as I can.20:59
godbykThanks for coming, monfort.20:59
monfortI'm really happy to start contributing and feel part of something great !20:59
monfortBy !20:59
issyl0(Ah, the satisfaction of making people happy.  :-))21:00
c7phehe yeah, just a motivate to keep contributing21:00
piratemurrayhi guys!21:01
issyl0c7p: Yeah.21:01
issyl0(Hrm.  I'll be back in 2 mins.  But, o/)21:02
c7pmeeting in 5 mins, raise your hands guys !21:02
piratemurraysounds good21:02
issyl0o/ before I disappear for two minutes...21:02
hannieok, 5 min21:02
rickfosbok 521:02
CrustyBarnacleOK 521:02
debayanI hope I can contribute properly.21:04
issyl0Right, hi.21:06
c7pdebayan: don't worry the team will help you to do it21:06
MootBotMeeting started at 15:09. The chair is godbyk.21:09
MootBotCommands Available: [TOPIC], [IDEA], [ACTION], [AGREED], [LINK], [VOTE]21:09
godbykHello, everyone. Thanks for coming.  Before we get started, can we have a quick roll call?  Just a quick 'hello' from anyone who's attending the meeting, please.21:10
shriniHello friends21:10
debayanHello everyone. Great to be here :)21:11
godbyk[TOPIC] Getting Started with 10.10: What still needs to be done?21:11
MootBotNew Topic:  Getting Started with 10.10: What still needs to be done?21:12
godbykI think the Maverick edition of the manual should be nearly ready for publication.21:12
godbykI know that we still need to take some screenshots.21:12
godbykWhat else needs to be done for this edition?21:12
hannieWhat's the use of publishing Maverick when Natty is coming so soon?21:13
issyl0I've done a fair bit of editing over the last few days - grammar/spelling/LaTeX/whatever.21:13
shriniI submitted some screenshots21:13
shrinido anyone get them?21:13
shriniare they useful?21:13
CrustyBarnacleReviewing Installation21:13
godbykhannie: Well, since it's practically finished already, there's no harm in it.  Also, it will serve as the base for the Natty edition.21:13
issyl0hannie: On the other side, what's the point of wasting a manual we've written?21:14
godbykshrini: Ah, I see that most of the screenshots have been submitted.  Great!21:14
godbykIt looks like there are just a handful of them missing still.21:14
shrinigodbyk: oh. thanks21:14
shrinii thought that they were not sent21:15
shrinito server21:15
godbykCrustyBarnacle: Would you like to look over the installation chapter of the maverick edition for us?21:15
godbykIt looks like we're just missing one screenshot and one is pending approval.21:15
CrustyBarnaclegodbyk Yes21:16
c7pthere is a problem with that screenshot, quickshot must have a bug21:16
godbykc7p: The pending screenshot or the missing screenshot?  Can we take it manually?21:16
c7pmaybe we can capture it manually and cut the image with gimp to make it proper for the manual21:16
godbykc7p: Okay. I'll look into that.21:17
CrustyBarnaclec7p: Shutter works great for taking and editing screenshots :-)21:17
godbykAre there any other to do items for the maverick edition that anyone can think of?21:17
c7pCrustyBarnacle: i love gimp :) but maybe i should try Shutter also21:18
hannieI like shutter too21:18
hanniequick and easy21:18
rickfosbgodbyk, when we are ready to 'publish', is it linked to the manual page (simple as that?)?21:18
godbykrickfosb: When we 'publish' the manual, we upload the PDFs to the website and also publish it to lulu.com (where you can purchase a printed copy).21:19
godbykAll right, let's move on to the Natty edition.21:19
godbyk[TOPIC] Natty edition authors and chapter editors21:20
MootBotNew Topic:  Natty edition authors and chapter editors21:20
CrustyBarnaclemsg rickfosb what is the publication date for Maverick? What's our deadline to get to translators?21:20
shriniThe GUI is so different in natty21:20
godbykEarlier this week, we asked for volunteers to write and edit the chapters of the Natty edition of the manual.21:20
shrinihave to write from scratch on the GUI part21:20
godbykWe also contacted the previous authors and editors to see if they'd like to reprise their roles.21:20
debayanI have some experience with unity.21:21
godbykThe list of assigned authors and editors is shown here: http://bit.ly/gG59j721:21
rickfosbCrustyBarnacle, We can probably try to set a date today,21:21
c7pthis is the list of assigned chapters to authors21:21
godbykc7p: We should ask the new volunteers if they have any preference as to which chapter they're assigned.21:22
c7pthere are like 8 authors and editors that aren't in this list because they haven't a chapter so don't worry21:22
hanniewho assigns them?21:22
c7pof course21:22
c7prickfosb will assign you the chapter21:22
rickfosbhannie, I'll work with them and assign21:23
rickfosbc7p, yes21:23
godbykIf anyone else would like to volunteer to be an author or editor, please feel free.21:23
c7pbut he is new so as most of you so don't make him anxious :)21:23
godbykWe'll take all the help we can get. :)21:23
rickfosbI'll reach out via email over the next day or so and start updating the list.21:24
CrustyBarnaclegodbyk: Indeed21:24
CrustyBarnacleshould we advertise for hel at LUGs?21:24
issyl0What's the ratio of editors to authors to chapters to applicants for roles?21:24
piratemurraycan i volunteer for the prologue?21:24
godbykCrustyBarnacle: Yes, feel free to advertise and help find some volunteers.21:25
issyl0Who controls that Google Doc?21:25
rickfosbpiratemurry, -> prologue21:25
rickfosblooks good21:25
c7pissyl0: i do21:25
hannieI have sent an email this morning21:26
rickfosbc7p, do you have nick to email for all of us?21:26
issyl0c7p: Ah, right.21:26
debayan_Hey I would like to take up the Ubuntu Desktop chapter.21:26
rickfosbpiratemurry, was the Author, or Editor?21:27
piratemurraywhat do you need?21:27
piratemurrayauthor would be first preference but i'm not fussed21:27
piratemurrayhappy to help in any way21:27
rickfosbpiratemurray; author or editor for prologue?21:27
hanniewho reads jobs@ubuntu-manual.org?21:27
shrinii like to be author of working with ubuntu21:28
rickfosbpiratemurray; thanks21:28
godbykhannie: A few of us do: me, c7p, cwoollard, rickfosb.21:28
piratemurrayrickfosb: so that is author then?21:28
rickfosbpiratemurray:  is Author for Prologue21:29
c7prickfosb: no i don't know the nicknames, PM me authors and editors21:29
CrustyBarnaclemsg c7p mario@petrielabs.com21:29
godbykCrustyBarnacle: Be sure to put a / in front of 'msg' otherwise it still sends it to the channel. :)21:29
shriniShall I take "Working with Ubuntu" ?21:30
issyl0CrustyBarnacle: You're missing a / before "msg". :-)21:30
rickfosbc7p; thanks.  Rest of you, I'll use the 'list' to reach out as needed.21:30
CrustyBarnacleI see...21:30
godbykOkay, shall we move on to the next agenda item?21:30
CrustyBarnaclelet's go...21:31
godbyk[TOPIC] Screenshot size for Natty edition21:31
MootBotNew Topic:  Screenshot size for Natty edition21:31
godbykc7p: Do you know what this topic is about?21:31
c7pi didn't write it :)21:32
godbykIn the agenda item, it says that the screenshots in the 10.04 edition of the manual are too large and that it's ahrd to read the text and look at the pictures at the same time.21:32
CrustyBarnaclemy vote is for the higher resolution, but sized down, so we get readable screenshots.21:32
godbykThey suggest using 800×600 resolution screenshots instead of the current 1024×768.21:33
shrini800x600 would be nice21:33
godbykI remember doing some tests early on when we started taking screenshots.21:33
godbykOne of the problems with reducing the screenshot resolution is that the screenshot start to look very pixelated and muddy at lower resolutions.21:33
hannieIs the quality fo 800x600 good enough?21:33
rickfosbI didn't write it either, but if you flip through the manual, some of the shots are full page, some rest within the main column... seems a mis match21:33
godbykrickfosb: Here's how the screenshot size in the manual is determined:21:34
godbykWe take all the screenshots at the same resolution (currently 1024×768).21:34
godbykThe widest screenshot (currently we use the full desktop screenshot for this) is scaled to fit in the margins of the manual (across the main text block and the sidenotes area).21:35
godbykAll of the screenshots are scaled using this same scaling factor.21:35
godbykIf the scaled screenshot is narrow enough to fit in the main text block, then it's centered there and the caption appears adjacent in the sidenotes area.21:36
rickfosbgodbyk; so, menu drop downs, etc., will be a small centered shot.. and desktop or full application will be large;  makes sense21:36
godbykIf the scaled screenshot is too wide for the main text block, then it will be centered across the full page (main text block + sidenotes area) and the caption will appear above or below the screenshot.21:36
CrustyBarnaclewhat if the max width was only main text block?21:37
godbykCrustyBarnacle: We could scale all the screenshots so that the max width is only the main text block, but then the text in the screenshots is difficult to read (as it's so small).21:38
rickfosbSo, back to question, do we have a sample of 800 vs 1024 to compare?21:38
CrustyBarnacleScreenshots are for reference only, not for providing actual instructions. So...21:38
godbykrickfosb: In the lucid-e1 repository, there is a lucid-screens/ dir that has samples taken at different resolutions.21:39
rickfosbI'll look21:40
godbykCrustyBarnacle: While the screenshots aren't there to provide instructions themselves, it is frustrating to not be able to read the text in the screenshot.21:40
issyl0godbyk: Absolutely.21:40
issyl0(Re: the frustration.)21:40
godbykThe samples in that directory are taken at 1024×768, 1280×800, and 800×600.21:40
CrustyBarnaclegodbyk: I see...21:40
godbykHaving said all that, we can certainly take another look at the problem and see if we can improve upon the previous (Lucid edition) solution.21:41
godbykDoes anyone else have any questions or comments on this topic?21:41
hanniecan you give us a link to the examples?21:42
debayan_I need to catch up with the instructions at http://ubuntu-manual.org/getinvolved/authors21:42
shriniis there any weblink available for a quick check on resolutions?21:42
CrustyBarnacleCan we agree to review the samples and discuss later (next meeting)?21:42
godbykhannie: http://bazaar.launchpad.net/~ubuntu-manual/ubuntu-manual/main/files/head:/lucid-screens/21:43
hanniethank you21:43
godbykCrustyBarnacle: Sure.21:43
rickfosbgodbyk, I'll review as well, but unless there is a compelling need to change...,  I'm ok with the current process.21:43
godbykAll right. Let's take a look at it and come back to our next meeting with our findings.21:44
godbyk[TOPIC] Do we need to provide screenshots for non-Unity users?21:44
MootBotNew Topic:  Do we need to provide screenshots for non-Unity users?21:44
godbykMy initial response to this question is, 'Sure, why not?'  But I'm not sure what concerns prompted the question.  Anyone else?21:45
shriniwhat do you mean by non-unity users?21:45
issyl0shrini: GNOME Classic?21:45
debayan_We will need to this because Unity crashes a lot, and many users are likely to go back to Gnome21:45
rickfosbI have one of the pc's that doen't support Unity.  So, I 'found' my way around the system menus;21:45
godbykshrini: I think they're referring to the users who will see the GNOME desktop instead of Unity due to lack of sufficient hardware to run Unity.21:45
CrustyBarnaclewould the screenshots be side-by-side or in a separate section?21:45
debayan_also the hardware support issue.21:45
issyl0If we provide screenshots for non-Unity users, we should provide narritive within the manual about GNOME too - is this feasible/likely?21:46
issyl0s/narritive/narrative/ sorry.21:46
godbykCrustyBarnacle: I think that the Unity and GNOME sections would be different.21:46
rickfosbI'm thinking we just need to cover the 'general' navigation issues.21:46
c7pwell regarding unity, from what i know there will be unity 2d for old pc and unity 3d for new machines -independs to hardware-21:46
debayan_I agree it should be different. Infact lets have separate manuals.21:46
shriniDoes the Gnome desktop comes in default ubuntu 11.04?21:46
piratemurraydo you not have to do some advanced tweaking to get GNOME back. i thought it was either Unity or Unity 2D (for the older computers)21:47
shrinior we have to install it separaely?21:47
godbykdebayan_: The problem with having two separate manuals it that you have to know beforehand which manual you need.21:47
hanniethe gnome part can be copied from Maverick I think21:47
rickfosbgodbyk; agree with one manual21:47
godbykdebayan_: One of the use cases for our manual is that I should be able to hand a copy of the manual along with an Ubuntu CD to a friend and they should be able to install and use Ubuntu without pestering me with incessant questions. :)21:47
CrustyBarnacleone manual...21:47
c7pyeah one manual to avoid confusion21:47
debayan_godbyk: hmm, good point.21:47
CrustyBarnaclegodbyk: Totally21:48
piratemurrayone manual to rule them all21:48
rickfosbI suspect that the 2d section would not be 'large' when compared to the changes we'll need to make to 3d21:48
godbykIs the person who added this agenda item present?  If so, can you explain your concerns a bit more?21:48
rickfosbgodbyk; that was me.  So, the concern is, do we need to support non unity users?  I have a new netbook, but it doesn't do unity 'as is'21:49
debayan_godbyk: I remember the openSuSE manual. It had Gnome and KDE parts separate.21:49
c7pfirst of all, we talk hypothetically ? are there tangible differences with unity 2d and unity 3d that will affect the manual ? first we should answer this -if anyone knows-21:49
godbykrickfosb: Ah, gotcha.21:50
debayan_rickfosb: You are expected to use unity 2d then.21:50
rickfosbgodbyk; poulsbo drivers aren't ready, yet.21:50
godbykI think that we should provide at least enough information that they know what they're looking at and provide pointers to further documentation.21:50
rickfosbespecially, if our graphic shows some nice application icons... and the user doesn't see them21:51
godbykPersonally, I'm not overly concerned about the size of the manual (as long as it doesn't get too out of hand), and would rather err on the side of including too much information than not enough.21:52
godbykIt's very disconcerting when you're following along in a manual and you've encountered a situation that the manual doesn't cover.21:52
issyl0godbyk: Definitely.21:52
* issyl0 agrees.21:52
CrustyBarnaclegodbyk: Would an increase change the cost to buy it?21:53
rickfosbagree;  Since I have a netbook with the 2d issue,  I can help out with providing some shots.21:53
godbykSo if we don't include information about GNOME classic (which may be reasonable if it's unlikely that most Natty users will encounter it), then we should at least make mention of it, explain why the reader may have encountered GNOME classic, and where they can go to get more information about it.21:53
godbykCrustyBarnacle: The price of the printed manuals is based on the page count. So the more pages in the manual, the more expensive it is.21:53
godbykrickfosb: Did this satisfactorily address your concerns for non-Unity users?21:54
godbyk[TOPIC] Documenting Ubuntu derivatives21:54
MootBotNew Topic:  Documenting Ubuntu derivatives21:54
shriniwhat are they?21:55
godbykUbuntu derivatives would be Kubuntu, Xubuntu, Edubuntu, etc.21:55
issyl0Ubuntu derivatives as in [X|K|Edu|...]buntu?21:55
debayan_There are differences in unity 2d and 3d http://www.omgubuntu.co.uk/2011/03/unity-2d-a-quick-look-at-the-latest-updates/21:55
hannieLike edubuntu, kubuntu, xubuntu?21:55
godbykRight now we mention those derivatives in the introduction, I think, but otherwise we don't talk about them at all.21:56
c7pyeah i agree21:56
piratemurraywe make mention of them? not a whole chapter though..... few paragraphs21:56
godbykThe question is, should we include more information about these derivatives in the manual?21:56
debayan_I agree, and we mention links.21:56
shriniI hope that little content is enough21:56
CrustyBarnacleMention + Links21:56
hannieYes, keep it short21:57
shrinibecause explaining KDE needs a full book21:57
piratemurraymaybe some reasons why one would want to use the derivite21:57
CrustyBarnacleCan we link to actual documentation for all derivatives?21:57
godbykMy concern is that I wouldn't talk about them to much in the beginning because you're forcing a choice on the unsuspecting reader.21:57
piratemurraysuch as "use Lubuntu if you want XYZ...."21:57
CrustyBarnaclegodbyk: good point21:57
godbykHow should the reader decide if they'd prefer a different derivative if they're just getting started with Ubuntu proper?21:57
debayan_We shoud mention it at the end.21:57
debayan_Advanced Topics.21:57
piratemurraythat's how i discovered the derivites when i started using ubuntu21:58
shriniThat would be fine21:58
godbykI could see adding a section toward the end of the manual that gives a page or two to discuss the pros and cons of each derivative and provides pointers to documentation about them.21:58
piratemurrayalmost as an advanced topic after i was comfortable with Linux/ Ubuntu21:58
shriniwith a screenshot?21:59
piratemurraygodbyk: yes21:59
godbykIt's also possible to write manuals for each individual derivative at some point in the future, but that's a lot of work. :)21:59
c7pgodbyk: cool, the learning more chapter can host this section21:59
rickfosbwere gonna need a bigger boat  :-)21:59
godbykc7p: I think that 'Learning More' would be a good place for this info, yeah.21:59
godbykrickfosb: Definitely!21:59
rickfosbc7p, agree21:59
CrustyBarnaclewho is updating notes?21:59
piratemurrayshrini: i wouldn't want to see screenshots of the different *buntus but that's just my opinion21:59
issyl0c7p: Yup.22:00
godbykBasically, any derivative manuals would warrant their own team of authors and editors.  (Though they can share our toolchain, etc.)22:00
godbykAre there any other thoughts on this or shall we move on to the next agenda item?22:01
godbyk[TOPIC] Useful applications (and how to install them)22:01
CrustyBarnacleNext :-)22:01
MootBotNew Topic:  Useful applications (and how to install them)22:01
godbykSome of the applications listed under this agenda item include Wine, Adobe Acrobat Reader, Inkscape, Chromium, Skype, and XBMC Media Center.22:02
shriniNo  acrobat reader22:02
issyl0Hrm.  An interesting one...22:02
godbykThe general question is, what applications should we discuss and how much detail should we go into?22:02
c7pshrini: i agree22:02
shriniit is huge22:02
debayan_we already have evince.22:03
shrinievince is great to read a pdf file22:03
CrustyBarnacleshrini: Agreed22:03
rickfosbI like the idea of 'Doing more...' but I would think we keep it simple with links to the source documentation?22:03
debayan_Skype also is not such a must have app.22:03
c7prickfosb: i agree22:03
c7pi don't think we need this chapter22:03
debayan_Not even Wine. People should really be using Windows if they need Wine.22:03
piratemurraydebayan: i'd disagree. many people migrating to ubuntu would like to see skype22:03
CrustyBarnacleI use Chromium... but don't want to start a browser feud.22:04
debayan_piratemurray: So they jst need to google.22:04
debayan_Skype hosts deb packages on their website, with instructions.22:04
piratemurrayarguably they can google everything in the manual22:04
shriniwe can say a like 'skype also available for ubuntu in their site<link here> '22:04
piratemurrayshould we not make light of the fact that skype et al are available in linux?22:04
piratemurrayshrini: yes22:04
shriniwe have to say about gimp22:05
debayan_piratemurray: I dont know if we should be pointing people towards installing proprieatary stuff on Ubuntu.22:05
c7premember that we are working on linux alternative apps table, and i think that's enough http://bit.ly/f0LTRQ22:05
debayan_proprietary *22:05
shriniwhat about multimedia codecs?22:05
debayan_shrini: Multimedia codecs can be covered in the chapter that covers playing media, because in ubuntu all you have to do is click a few buttons.22:06
shrinidebayan_: thats fine22:06
godbykshrini: We do mention the restricted drivers and ubuntu-restricted-extras package.22:06
CrustyBarnacleWe mention the Installation option of selecting "third-party software" in Installation22:06
shrinigodbyk: good22:07
godbykThe ubuntu-restricted-extras package is mentioned in the troubleshooting chapter.22:07
shriniwhat about XMBC?22:07
godbykshrini: That's not mentioned.22:07
shriniis it available in repository as default?22:07
CrustyBarnacleXMBC is not desktop use, right?22:07
godbykThough Mythbuntu and MythTV are.22:08
shriniit is not there in my 10.10 repos as default22:08
shriniwe can say about cheese22:09
godbykDo you think that the Linux/Windows app equivalences table will be sufficient?  Or do we need to go into more detail?22:09
godbykIf we need to go into more detail, should that detail be in this manual or in a separate document?22:09
shrinithat table would be so fine22:09
debayan_godbyk: Table should be sufficient. The instructions for third party apps may change as well.22:09
CrustyBarnacleTable looks good...22:10
godbyk[TOPIC] Upload chapters for translation as they are completed22:10
rickfosbgodbyk; does it format for latex or do we link it?22:10
MootBotNew Topic:  Upload chapters for translation as they are completed22:10
godbykhannie: Did you or rickfosb add this item?22:10
rickfosbwasn't me22:11
godbykrickfosb: Does what format for LaTeX?22:11
hannieI did22:11
hannieI wonder if this is possible22:11
godbykhannie: Okay. If I understand correctly, you'd like us to upload chapters for translation as they're completed instead of waiting for a manual-wide writing freeze. Is that correct?22:11
rickfosbgodby; last topic... does the table format easily for inclusion22:11
hannieI mean, put the manual on Lp chapter by chapter22:11
godbykI don't think it's possible with our current toolchain.  Presently, all the chapters are mashed together before the .pot file is generated.22:12
c7pa good solution to this could be the following22:12
godbykrickfosb: Ah, I haven't looked at the table, but LaTeX can handle tables.22:12
hannieOr chapters could be translated offline (text files?)22:12
rickfosbok, moving on... thanks22:13
issyl0godbyk: LaTeX table syntax looks more complicated than it is.  :-)22:13
piratemurraysurely the translators will check out the latest bzr LaTeX files and translate those directly? am i missing something?22:13
godbykpiratemurray: The way translations currently work is:22:13
godbykWe write and edit the .tex files until we hit the writing freeze date.22:14
c7phannie:  the whole manual is a series of strings, hopefully the strings are with the same queue as are paragraphs -except for margin notes-, we can give a list of string numbers per chapter22:14
godbykThen we run a script that reads all the .tex files and generates a .pot file.22:14
godbykthis .pot file gets uploaded to launchpad for the translators.22:14
godbykThe translators can work on translations via Launchpad or offline tools.22:14
c7pe.g from 504 string up to 642 string = "Working with Ubuntu" chapter22:14
hannieWhen the whole manual is finished, it is too late for translators to finish it before in time22:15
godbykPeriodically, I'll download the .po files (which contain the translated text) for each language and generate draft PDFs that show their progress.22:15
hanniethat's why I would like to get each finished chapter as soon as possible22:15
CrustyBarnaclePossible to do an earlier freeze date for longer chapters?22:15
godbykThe problem is that if we make a change to the English .tex file and generate a new .pot file and upload that to Launchpad, it can (and often does) disrupt things that the translators have already translated.22:16
rickfosbgodbyk; as we 'commit', could we 'send' the corresponding tex file?22:16
shriniwe suffered by this for tamil translations22:17
godbykrickfosb: For that to work, we'd need to have a separate .pot file per chapter.  (As it stands, there's currently just the one .pot file for the entire manual.)22:17
c7pwe don't have to rush, authors and editor should have all the time they need to write the content of the manual22:17
godbykI'm not sure if generating one .pot file per chapter is possible or not.  (I'd assume it is, but the script we're using is a bit awkward to use.)22:17
piratemurrayi'm a bit confused here, why can't we diff the uploaded LaTeX files and only translate the difference? we're essentially talking about a branching problem in a version controlled system, right?22:17
hanniegodbyk, that is exactly what I want, each chapter separately22:17
godbykpiratemurray: The translators aren't working with .tex files. They're working with a derivative of the .tex files (a .pot file).22:18
rickfosbseems breaking it into chapters would resolve the conflict between english and the translators22:18
piratemurraygodbyk: and why can't they work on the .tex file? it is a plain text file right?22:18
CrustyBarnacleCan those who understand the process put together a summary of what this request would require? Feasible?22:18
hanniegodbyk, I could ask david planella if it can be realised22:18
godbykhannie: I'll give it a try and see if I can coerce the script to generate one .pot file per chapter.  No promises, though! :)22:18
debayan_piratemurray: .pot is the standard way for i18n. yo can use offline tools like kbabel to translate.22:18
godbykhannie: We're currently using a script called po4a (po-for-anything), in case he's familiar with it.22:19
hanniegodbyk, ok22:19
debayan_.pot files allow you to translate the strings to a wide number of languages using available interaces that understand and interpret .pot files and enale easy edition.22:19
piratemurrayall right so the problem here is that we *must* use .pot files to give to the translators?22:20
hanniethe advantage of Launchpad is that many translators can work on the same document22:20
piratemurrayi'm being dense, forgive me. i haven't used .pot files before22:20
debayan_piratemurray: that is how internationalisation works everywhere. .pot files.22:21
godbykpiratemurray: Well, we must use .pot files for the translators to be able to do their work via the Launchpad translation interface.22:21
piratemurrayand at the moment the .pot is the full manual and potentially when that is realised it is too late in terms of release deadlines?22:21
piratemurrayfair enough, i'm with you now. splitting them into chapter seems a sensible way forward in that case22:22
rickfosbgodbyk; is the pot generated in the makefile? or elsewhere?22:22
hanniegodbyk, we'll just wait and see what comes of it22:22
godbykrickfosb: I don't think we've added that to the Makefile (though we should).  I have the magic incantation somewhere in my notes.22:22
CrustyBarnaclegodbyk: Do we use translation memory (some auto translation approved by actual translators)?22:22
hannieCrustyBarnacle, we do22:23
godbykhannie: Yeah. I'll try running po4a against a chapter .tex file (instead of the entire manual) sometime this week and see how much it hates that.22:23
rickfosbgodbyk; ok, thought it might make chapter generation possible if it is in our make22:23
* c7p godbyk is project's hero replying to everyone and doing everything !22:23
godbykCrustyBarnacle: Via Launchpad, that's provided automatically (if it's a perfect match of an existing translation).22:23
CrustyBarnaclegodbyk: Thanks...22:23
hanniegodbyk, I would be very grateful if you give it a try22:23
godbykhannie: Sure thing.22:24
godbyk[TOPIC] Any other business22:24
MootBotNew Topic:  Any other business22:24
godbykOkay, any other business anyone would like to bring up?22:24
godbykQuestions, comments, concerns, criticisms?22:24
c7pi have22:24
shrinimove the quickshot to ubuntu-manual.org site22:24
shrinidocument it well22:24
shrinisend some acknowledge mail for the generated screenshots22:25
godbykshrini: I'll have to see what framework they're using for the Quickshot server.22:25
shrinisend email about approval/denial of screenshot22:25
shrinigodbyk: okey22:25
godbykshrini: Good ideas.  Can you file those are bugs/feature requests against Quickshot on Launchpad?22:26
godbykThat way they won't get lost in the fray and they'll come to the attention of the Quickshot developers.22:26
shriniatleast say about quick shot server details on ubuntu-manual site22:26
shrinicurrently no information is available there on how to get the .qsproj files22:26
godbykWasn't someone documenting the new Quickshot?  c7p, were you?22:26
c7pi'm working on the http://ubuntu-manual.org/getinvolved/authors , i will update the content of the page soon, what i need the feedback from new authors and editors22:26
godbykshrini: Yeah, it's all a bit mysterious still.22:27
c7pgodbyk: i'm not sure, maybe it was me :P22:27
c7pi have some guidelines22:27
c7pmaybe i should upload them too website22:27
piratemurrayi have a question about chapters: are we going for a complete rewrite or where possible do you want to stick to what was done in previous UM releases?22:28
piratemurray(sorry to jump in like that)22:28
debayan_piratemurray: Some chapters, like the Ubuntu desktop will need complete rewrite i think.22:28
godbykpiratemurray: No sense making more work for yourself. If the existing text is still accurate and well-written, keep it around.22:28
godbykFor things that are completely new to Natty (e.g., Unity, Shotwell, etc.), we'll need to write new text.22:29
piratemurrayfair enough! sounds good22:29
hannieHow about all the gaps on the Authors/Editors page?22:29
godbykhannie: Can you be more specific?22:29
hannieAre there enough candidates?22:29
hannieI seen no names behind most of the chapters22:30
godbykOh, in the spreadsheet?  We do have half a dozen or so volunteers that we need to add to that spreadsheet.22:30
godbykBut we always welcome more volunteers.22:30
rickfosbhannie; I'm in contact with some and will start filling in the blanks as soon as possible22:30
godbykSome of the chapters are rather lengthy and would benefit from a couple authors and editors to help share the workload.22:30
debayan_I would like to have a go at "The Ubuntu Desktop". I have experience with Unity.22:31
rickfosbdebayan_; author?22:31
godbykThanks, debayan_.22:31
debayan_rickfosb: yes. Partly atleast.22:31
rickfosbI'll add you to the list22:31
hannieI have volunteered for the job of editor, but since I am not a native speaker I do not22:31
debayan_Not sure how huge the chapter will be yet.22:31
hannieknow if that is ok22:31
godbykhannie: It's absolutely okay.  The more eyes/readers, the better.22:32
hannieok, you will read it in my email22:32
shriniDo I need to learn latrex to be an author?22:32
rickfosbhannie; got a chapter in mind?  I'll add you22:32
debayan_What maling list do we join for this ?22:32
godbykI've found that translators are good at catching common English idioms that sneak into the text.22:32
rickfosbhannie; ok22:32
hannieI put Ubuntu Desktop in my email, but there is also another candiate for taht22:33
godbykdebayan_: The Ubuntu Manual mailing list -- it's linked to on the Ubuntu Manual Launchpad page.22:33
godbykdebayan_: http://launchpad.net/ubuntu-manual22:33
debayan_ok fine. I joined that.22:33
shrinigodbyk: Is latex is essential to start authoring?22:33
shrinigodbyk: or shall I use OpenOffice to start writing?22:33
godbykshrini: It's not essential.  If you write well, we can find someone else to help with the formatting.22:33
godbykI would recommend writing it in plain text instead of OpenOffice, though.22:33
shriniI agree22:34
godbykFor the authors and editors, LaTeX is basically a markup language like HTML.22:34
rickfosbshrini; the chapter editor and I can help put the tags into the text.22:34
shriniI use asciidoc for my other documentation works22:34
godbykSo it's plain text for the most part with some extra code to handle the formatting.22:34
debayan_Its 3:10 AM here in India. I would take your leave, if all important issues have been discussed.22:34
shrinidebayan_: :-) ofcourse22:35
godbykdebayan_: I think we've about finished here.  Thanks for coming (and staying up so late)!.22:35
issyl0debayan_: Goodnight!22:35
c7pdebayan_: thx for coming :) good night22:35
hanniedebayan_, it was nice meeting you here.22:35
shrinicrossed all the sleep limits22:35
CrustyBarnacleGoodnight, and Thanks to all!22:35
debayan_godbyk: issyl0 shrini hannie no problem. Good Night.22:35
shrinisame here guys.22:35
shrinime too at 3.10 am22:36
godbykThanks for coming, shrini.22:36
CrustyBarnacleGreat to meet everyone22:36
shrinithanks for all22:36
CrustyBarnacleThis team rocks!!22:36
hannieshrini, goodnight to you too22:36
godbykAre there any other last-minute issues?22:36
shrinithanks hannie c7p godbyk CrustyBarnacle rickfosb22:36
hannieThere is work to do for a lot of people ;)22:37
c7pgodbyk: i don't think so22:37
godbykAll right, then.22:37
godbykMeeting adjourned!22:37
c7pthank you all for coming ! good job godbyk22:37
MootBotMeeting finished at 16:37.22:37
godbykThanks for coming, everyone.22:37
rickfosbGood meeting godbyk!22:38
hanniethanks everybody, see you next time22:38
piratemurraythanks everyone!22:38
shrinibye for all22:39
rickfosbc7p; i'll read the changes you sent over now22:39
c7prickfosb ok thx :)22:39
rickfosbbye all;22:45
=== godbyk changed the topic of #ubuntu-manual to: Ubuntu Manual Project discussion | Style Guide: http://files.ubuntu-manual.org/style-guide.pdf | Website: http://ubuntu-manual.org | Launchpad: https://launchpad.net/ubuntu-manual | IRC logs: http://irclogs.ubuntu.com

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