/srv/irclogs.ubuntu.com/2010/11/29/#ubuntu-manual.txt

ChrisWoollardFor your information -> O'Reilly Media09:23
ChrisWoollard*Free to Choose* Deal/Day: Save 60% ALL ebooks & videos! Code DDF2H #CyberMonday http://oreil.ly/free2choose09:23
nisshhaquarius, sorry, i forgot about the hack session we were going to do on monday, my bad, is now a good time?14:15
nisshhim free for the next couple of hours14:16
aquariusnisshh, heya, pal. Yeah, now's good14:18
nisshhaquarius, cool, so have you created your chapter and pushed it to the branch?14:19
aquariusnisshh, not yet, no; I only created something just to play around. I thought we'd talk about what should be in it14:19
nisshhfair enough14:19
nisshhaquarius, so what is in the sample app that uses desktopcouch?14:20
nisshhthats what the chapter will be about, as well as a general introduction to couchdb itself i guess14:20
aquariusnisshh, that's what I'm not sure about -- is there one sample app for the whole book, or is there just one for my chapter? (Sorry, I haven't kept up on this sort of thing.)14:21
nisshhaquarius, look in the branch, there is a directory called sample-app or something similar, there is one sample app for the whole manual14:22
nisshhthe whole sample app is in there14:22
aquariusk. It seems to be called "feed reader" :)14:23
nisshhyeah14:23
nisshhits supposed to be an identica client prettymuch14:24
aquariusok. At the moment it just fetches an RSS feed and displays the contents in a DictionaryGrid14:25
nisshhyeah14:25
aquariuswhat else is it planned to do? :)14:25
nisshhi think thats as far as Rick got when he was creating it14:26
aquariusoh. heh :)14:26
aquariusalso, uses BeautifulSoup for parsing xml. ouch. Still, that's not what we're working on :)14:26
nisshhyeah14:27
aquariuswhat else should we do? I mean, I don't want to do anything to do with posting to identica or anything, because the way you should do that (as part of the platform!) is to use libgwibber.14:27
nisshhyeah14:28
nisshhaquarius, Rick keeps telling me he wants to re write the whole sample app, but he hasnt told me what he wants to change/improve etc, so i dont know what part will use desktopcouch, etc14:29
aquariusthen it is difficult to know what I should write about :)14:30
aquariusso, let's leave that aside for now, and talk about section headings14:30
nisshhyep14:31
aquariusmy inclination is to write about the following things: what desktopcouch is, what benefits it provides over other storage approaches, how it ties into Ubuntu One; how to createa  database, store things in it, read things from it; how to query your desktopcouch data store; how to view the data in it for debugging; some thoughts on the sort of data you should or should not store therein; pointers to external re14:32
aquariussources.14:32
nisshhthat sounds good14:32
nisshhaquarius, thats just about the perfect order to put it all in too14:33
aquariusthat's what I thought. :)14:33
aquariusand obviously once I know what the sample app is going to be, I'll illustrate that with examples taken from the sample app.14:34
nisshhaquarius, well, the idea is that the manual is used to teach the reader how to create a working copy of the sample app14:34
aquarius*nod* absolutely14:35
aquariusbut I can't illustrate examples from the sample app if I don't know what the sample app is going to do. Need to talk to rickspencer3 once he gets here, I suppose14:35
nisshhyeah14:35
nisshhwe also want the user to learn by doing, not by just copy/pasting14:36
nisshhso encouragement to experiment and add things is a big plus14:36
nisshhaquarius, are you able to hang around till rick joins? so we can discuss this together?14:37
aquariussure thing14:38
nisshhcool14:38
nisshhis he travelling or something though, i havent seen him on IRC for a couple of days now14:39
nisshhhopefully he will be on in the next couple of hours14:39
nisshhaquarius, rick's here14:46
nisshhrickspencer3, whats the deal with the sample app currently? you mentioned a while ago you wanted to redo it completely14:47
rickspencer3nisshh, I don't know that i want to redo it completely, since there's hardly any code for it14:47
rickspencer3what's up?14:47
nisshhwell, aquarius is just sorting out his chapter and what is in it, he doesnt know what part of the sample app will be using desktopcouch14:48
nisshhhence, he cant write that part of his chapter14:49
aquariusrickspencer3, essentially, I can decide to add some new stuff to the sample app which uses DC, but I don't know what more you want to do with the sample app than what it already does14:49
rickspencer3aquarius, I don't really know either14:50
aquarius:)14:50
rickspencer3I guess you could just store some configuration data or something?14:50
aquariusright, if you don't have a specific plan, then I'll do something appropriate. No worries.14:50
rickspencer3cool14:50
nisshhexcellent14:51
aquariusnisshh, so, we need to talk about what else the sample app will do in other chapters. At the moment there's nothing in the app for desktopcouch to do, because the app hardcodes one specific identica feed and displays it in a window. Don't need configuration or storage for that ;) So, what are other people planning to do to it?14:51
nisshhaquarius, well, there is an indicator applets chapter14:53
nisshhpretty self explanitory what that does14:53
aquariusah, so that'll integrate the sample app into the Messaging Menu?14:53
nisshhjono was going to write a gstreamer chapter, but he no longer has time14:53
aquariusagain, doesn't really need storage or configuration.14:53
nisshhyeah, either the messaging menu or on its own14:53
nisshhaquarius, maybe the sample app could have to ability to fetch and display multiple peoples timelines, and the URL's could be stored in couchdb?14:54
nisshhim not sure how efficient that would be though, tbh14:55
nisshhand im not sure if libgwibber has support for that yet14:55
aquariusnisshh, sure, although...then it's a general identica reader. Which is what gwibber is for, and that's part of the platform :) I'm not brilliantly keen on duplicating what libgwibber does.14:55
nisshhaquarius, well, this is not necessarily for the user to release into the wild, just for them to learn, maybe we should say that in the manual?14:56
aquariusnisshh, oh, agreed, but having our manual which says "use the platform: here, look, here is a sample app which doesn't use the platform but instead reimplements some of it, so you can learn" is a pretty mixed message ;)14:57
nisshhtrue :)14:57
aquariusI'm thinking about, perhaps, remembering which items you've read, which items you've expanded, something like that14:57
nisshhso an RSS reader? not an identica reader?14:58
nisshhaquarius, ^^^14:58
aquariusnot sure. At the moment, the items are all wider than the window; I was wondering about expanding an individual item to be larger which would show details of the user who posted it, something like that14:58
aquariusbut I don't think I like that idea14:59
aquariusat the moment it *is* an rss reader, it just happens to be reading a feed from identica ;)14:59
nisshhyeah14:59
nisshhthats true14:59
nisshhaquarius, i think have a general feed reader and use your idea of having it remember unread/read/expanded, etc, using couchdb15:02
nisshhsounds like a good idea, but is it doable?15:02
aquariusdepends on what you mean by doable15:03
aquariusto make this a general feed reader, we need to maintain the list of feeds (fine to do in DC), and allow people to edit that list (which requires UI)15:04
nisshhaquarius, well, is it a reasonable use case of desktopcouch? is it simple enough for a new developer to understand? will the code be clean or will it be all hacky?15:04
nisshhyeah15:04
aquariusstoring your list of feeds in DC is a fine use of desktopcouch -- your list of subscriptions then follows you around15:05
nisshhyeah15:05
nisshhthat should be pretty simple to do actually15:05
nisshhaquarius, so are you happy to do that?15:06
nisshhalthough, i dont have a use for gstreamer in the sample app :)15:07
aquariuswell, I am, but I don't know that I'll have time to write up those changes in other chapters15:07
nisshhwhich changes in other apps?15:07
nisshhchapters*15:07
aquariuswell, if I change the UI, for example, do other already-written chapters have screenshots of the UI? Or snippets of code from the sample app which I'll now be altering?15:08
nisshhaquarius, there are no screenshots in the manual yet, although the code might have to be changed a bit in other chapters15:08
aquariusyeah. that's what I don't think I'll have time to do15:09
nisshhaquarius, i tell you what, if your happy to change the code relating to your chapter, i will change any other required code15:09
aquariusaltering the sample app, adding DC support to remember the feed list and other things, and writing the DC chapter15:09
aquariusah, ok, cool :)15:09
nisshhyeah15:09
nisshhif you do that, ill do any code changes needed in other chapters15:09
nisshhnone of the other chapters are actually finished yet15:10
nisshhall the code needs bringing in line with the sample app, currently its all just generic examples15:10
nisshhgodbyk, ping15:11
nisshhaquarius, even if you just write bits of the chapter whenever you have small amounts of free time, that would be enough so that most of the chapter would be there by release time15:12
nisshhor even sooner if we work hard :)15:13
aquarius*nod*15:13
aquariuswhat's "release time"?15:13
aquariusThursday?15:13
nisshhlol, nope15:13
nisshhi think that alpha1 snapshot was too optimistic15:13
nisshh:)15:13
aquariusi thought it was, too, but I didn't want to piss on your bonfire :)15:13
nisshhno, no, you were right15:14
nisshhi prefer people to be honest with me and just say what they think rather than "not piss on my bonfire" :)15:14
nisshhaquarius, so, roughly a month or so before natty's release there will be a string freeze where no content can be changed, this is so translators dont constantly get their translations disappearing :)15:16
nisshhand then hopefully the manual will get released around natty final release15:16
aquarius:)15:17
* aquarius laughs15:17
nisshhand about a week or two before string freeze i want to get as many eyes on the manual as possible so we can catch formatting and grammer bugs, style issues, etc15:17
nisshhhehe15:17
aquariusI shall try and tell you in future, then, but I avoid telling people how to run their project ;)15:17
nisshhhehe15:18
aquariusso I've got a little while. If I don't have at least a provisional version of the chapter written by, let's say, middle of next week, then moan at me? I should have something by then.15:18
nisshhaquarius, its not "my" project its "our" project :)15:18
aquariusyou're the boss, boss. :)15:19
nisshhaquarius, well, natty final release is end of next april right? so string freeze will be end of march or so, as long as you have a good draft by next february ill be happy :)15:19
nisshhhaha15:19
nisshhaquarius, i welcome any suggestions people may have to help me run the project better :)15:20
aquariusthe way to get me to do something is emphatically not to say "you have three months to do it in". Next week. I am not good with long deadlines ;)15:20
nisshhi see15:21
nisshhhehe15:21
nisshhaquarius, ok, you have 3 hours :)15:21
aquariusha!15:21
nisshhi think im getting the hang of this :)15:22
aquariusI admire your management technique, but not your understanding of my workload. Some sort of middle ground ;)15:22
nisshhaquarius, i guess as long as im seeing progress :)15:22
nisshhwell thats just it, i have no idea what your workload is like, you see, so i have to just account for a large workload, like so many of you guys have :)15:23
nisshhwhich is why i started off with a long deadline15:23
nisshhaquarius, so, yeah, next week, rough draft of most of the chapter would be good :)15:24
nisshhi will start bugging you about this time next week if i havent seen anything new in the branch though :)15:25
aquariusthat's perfecr15:25
aquariusI need a progress chaser for stuff like this. Well volunteered ;)15:26
nisshhcool15:26
nisshhaquarius, im not exactly experienced at running a project, but i realise now that chasing things up and making sure they get done is a big part of it :)15:27
aquariusit's damned nearly the only part of it, but don't tell anyone I said that. :P15:27
nisshhhaha15:27
nisshhaquarius, ping me anytime if you have any issues15:28
nisshh(with the manual)15:29
aquariuscheers, pal15:29
nisshh:)15:29
ChrisWoollardnisshh: godbyk messaged me earlier. He is around later and I will talk to him about the font issues then.17:03
ChrisWoollardwas there anything else that you needed from him while i have got him?17:05
nisshhChrisWoollard, nah, thats why i pinged him, thanks dude :)17:09
ChrisWoollardhe is around later so. hopefully we can sort it17:09
ChrisWoollardhave you thought of coverpages?17:10
ChrisWoollardI am going out for a while. catch you later.17:16
godbykHey, nisshh.  Still around?18:28
nisshhgodbyk, yep18:30
nisshhgodbyk, whats up?18:32
godbykI just got back from holiday (Thanksgiving).18:36
godbykThen I had meetings this morning.18:37
nisshhfair enough18:37
godbykNow I can finally get back to real work again. :-)18:37
nisshhhehe18:37
godbykWere you wanting to pester me about the font stuff in the dev guide?18:37
nisshhnot pester :)18:37
nisshhi was just going to ask you if you knew WHY it was happening and what we can do to fix it/work around it18:38
nisshhi realise it must the Ubuntu font, but im not sure why it doesnt display special characters correctly18:38
godbykRegarding bug 682057, it's because the \then command tries to print a Unicode character that doesn't (yet) exist in the Ubuntu fonts.18:38
manualbotLaunchpad bug 682057 in ubuntu-developer-manual "Characters not supported by the Ubuntu Font." [High,Confirmed] https://launchpad.net/bugs/68205718:38
nisshhi see18:39
nisshhso i guess we just have to wait till these missing unicode characters get added to the font?18:39
nisshhgodbyk, ^^^18:39
godbykIt tries to print ‣ (U+2023), but that character doesn't exist in the Ubuntu font.18:40
godbykThere are a few workarounds available.18:40
nisshhcool18:40
godbyk1. Print that character from a different font.  (Easy enough to do.)18:40
godbyk2. Pick a different font for the text.  (I don't think Ubuntu looks terribly good for the text font in this case, frankly.)18:40
dutchieuse a different character?18:41
godbykYou could use a different character within the Ubuntu font, too, if an appropriate one were availab.e18:41
godbykavailable, rather.18:41
dutchiedoes it have  → ?18:41
nisshhyeah18:41
nisshhdutchie, oh, urgh, not that arrow character, that looks so ugly :)18:42
godbykdutchie only picked that one because it gives him an excuse to use the compose key. ;-)18:42
nisshhhaha18:42
dutchiegodbyk: maybe ;)18:43
dutchiediscovered a fun new character you can do with compose the other day18:43
nisshhgodbyk, tbh, i think its the way evince renders the PDF that makes the Ubuntu font look crap18:44
dutchie18:44
nisshhits a bit blurry18:44
dutchiethere's always ‽ too18:45
nisshhdutchie, lol, that is a strange symbol :)18:45
OmegaHah, dutchie, I wasn't expecting that in this channel.18:45
dutchieOmega: compose CCCP (make sure it's capitals)18:45
nisshhwow, everyone is awake tonight :)18:45
OmegaI'm in an anarchy channel.18:45
OmegaAnd I was just about to switch to it18:46
OmegaAnd I saw your hammer and sickle18:46
godbykIs there a cool way to define new compose-key combinations?18:47
godbyk('cool' meaning 'doesn't require godbyk to recompile things')18:47
nisshhgodbyk, anyway, could we get back to the bug? :)18:47
dutchiegodbyk: pretty sure there is18:48
dutchie~/.xmodmap or some such18:48
nisshhoh god, i HATE that file with a vengeance :)18:48
nisshhgodbyk, regarding the options you gave me before, shall we try number 1?18:49
godbyknisshh: We can, yes.18:50
godbykLet me give it a shot real quick.18:50
nisshhdutchie, its very strange, i have a logitech G15 keyboard right, .xmodmap breaks my keyboard and stops it from working at all, g15-tools makes it work a bit better but disables the extra G keys and just default setup works fine except for the M keys and the LCD :)18:51
dutchiehandy :)18:51
nisshhi will never win with this i swear :)18:51
dutchiei wonder if that's the same one the guy from #ubuntu-uk was writing drivers for18:51
nisshhpossibly, although there is the G19 and G11 as well18:52
nisshhG19 being the newest18:52
dutchie18:52:59 < Azelphur> the Logitech G1918:53
dutchie18:53:05 < Azelphur> and other G-Series devices18:53
godbyknisshh: that works for now. I'll commit the change real quick.18:54
nisshhdutchie, cool18:54
nisshhgodbyk, cheers18:54
dutchienisshh: and btw, it's not Azelphur writing it, but ali123418:54
nisshhyeah, i dont know who that is though :)18:55
dutchieAzelphur was doing some front-end or something18:55
dutchienisshh: just so you don't go annoying the wrong guy :)18:55
nisshhdutchie, unless it works 100% ill stick with default setup :)18:55
godbyknisshh: Committed as r21.18:55
nisshhyeah18:55
nisshhgodbyk, cool18:55
nisshhgodbyk, yeah, it looks awesome :)18:57
godbykWell, not awesome, but ever-so-slightly-better than before. :-)18:58
nisshhhaha18:59
nisshhgodbyk, well, i still think its evince that is rendering the font badly, the Ubuntu font on my desktop is super sharp18:59
godbykWill a lot more material be going into the manual?18:59
godbykDifferent types of material?18:59
nisshhyes to your first question, not sure what you mean by different types19:00
nisshhwe have 2-3 chapters to add in still19:00
godbykI think Ubuntu is fine as a UI font; it just doesn't look very good as a book font, in my opinion.19:00
nisshhi agree somewhat19:00
godbykDifferent types: body text, code listings, captions, side notes, ... Anything that isn't already provided for by the current manual style?19:01
nisshhgodbyk, we hired a technical writer (well, canonical did) to oversee the editing of the manual and developer.ubuntu.com :)19:01
godbykWow!19:01
nisshhshe starts tomorrow and is helping us till march next year :)19:01
nisshhfreaking awesome :)19:01
nisshhgodbyk, there are a few minor things, like i wish it didnt indent the start of each paragraph, makes it look terrible19:02
godbykOkay.19:02
nisshhand the code font looks WAY too similar to the Ubuntu font19:02
nisshhit needs to look more different, so the reader can easily tell the difference19:03
godbykI'd like to have a good idea of what kind of content will be needed (and some samples to work with) so I can work on the design of the book.19:03
godbykI agree.19:03
nisshhgodbyk, well, the consensus among the team is to go with the new Ubuntu branding colors19:03
godbyk'kay.19:04
nisshhand we havent discussed the cover page yet19:04
godbykI'll be updating our manual with the Ubuntu colors, too, when I get time to test them in print.19:04
nisshhcool, maybe you can do both manuals colors then?19:04
godbykYou should sic thorwil on the cover page.  He always comes up with amazing stuff.19:04
nisshhyeah19:04
nisshhi already did19:04
godbykDo you guys have a meeting at some point? Maybe I can stop in and chat with you about the book design. See what you guys had in mind.19:05
nisshhhe said just come back to him with any images and a description of the look i want and he will knock one up19:05
godbykSweet.19:05
nisshhgodbyk, we were trying to organize a sprint somewhere, but that wont happen now :)19:06
nisshhwe will probably have a meeting sometime soon19:06
godbykWell, I just meant an irc meeting.19:06
godbyk:)19:06
nisshhyeah19:06
nisshhi think we are all having a skype call with the tech editor later this week19:06
nisshhso maybe then would be a good idea19:06
nisshhgodbyk, ill let you know when something comes up :)19:07
godbykcool.19:07
godbyknisshh: are you guys planning on releasing this with natty? or sooner than that?  (what's your timeline?)19:07
nisshhgodbyk, yeah, with natty19:07
nisshhwriting freexe in march most likely19:07
nisshhfreeze*19:08
godbykOkay.19:08
nisshhi think we are making good progress, i am pushing everyone hard and chasing up all the loose ends :()19:08
nisshhi only have another two chapters to sort out now :)19:09
nisshhoh, plus jenkins chapters19:09
godbykI'd like to use the listings package for the code listings. It'll make things look nicer.19:10
nisshhgodbyk, listings package?19:11
godbykThe downside is that there was a nasty bug between it and polyglossia/babel last I looked.19:11
godbyknisshh: http://tug.ctan.org/tex-archive/macros/latex/contrib/listings/listings.pdf19:11
godbykIt adds things like line numbering.19:12
godbykAnd syntax highlighting.19:12
nisshhvery nice19:12
nisshhthat would be awesome19:13
nisshhgodbyk, because then we could say things like "see line x in the following example:"19:13
nisshhinstead of "see the fourth line from the bottom in the following example:"19:14
nisshhand the syntax highlighting would make it so much more readable19:14
godbyknisshh: precisely.19:15
nisshhyeah19:15
nisshhgodbyk, remember those tables i wanted to turn into columned lists a while ago? well, they arent displaying properly still :)19:16
godbyknisshh: can you give me a page number?19:17
nisshhgodbyk, hmm, one sec19:18
nisshhgodbyk, pages 7 & 819:20
godbyknisshh: Ah, I see.. Where it's centering the first columns on the page?19:24
nisshhyeah, and it indents the last column too19:25
nisshhgodbyk, anyway dude, i need to get some sleep, if you fix the issue, just commit it to trunk and ill see it in the morning :)19:25
godbyknisshh: I'll see what I can do.  G'night!19:26
nisshhgnight, thanks godbyk :)19:27
* nisshh is sleeping now :)19:27

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