/srv/irclogs.ubuntu.com/2010/01/27/#ubuntu-manual.txt

=== IlyaHaykinson1 is now known as IlyaHaykinson_
dutchiehumphreybc: leave a message after the tone ;)03:38
dutchiehumphreybc: I am now fast asleep, most likely, and am unlikely to be on IRC for a while. Email is probably your best bet to grab hold of me03:38
dutchiehumphreybc: these are automated messages, hopefully produced as soon as you come online thanks to the postpone.pl irssi script03:38
dutchiehumphreybc: pong, done, get a better time zone03:38
humphreybcha!03:38
humphreybcIlyaHaykinson: I'm going to start sending emails to authors soon03:56
humphreybcMy laptop battery charger has given up the ghost... i'm hoping to get another one by friday. sometimes it works, sometimes it doesn't - it's working at the moment!03:57
humphreybcBut if I disappear for a few days it's because it's really died and I haven't got another computer/charger03:57
IlyaHaykinsonhumphreybc: gotcha.05:14
nisshhhey dutcjie05:49
nisshhdutchie05:49
nisshhi found an error on the new planet website05:49
nisshha broken link05:49
nisshhits the identica link at the top right of the main pagre05:50
humphreybcnisshh: how are you going with chapter 7?06:13
nisshhjust fixing two bugs now06:14
nisshhand writing another section  or two06:14
humphreybchow far through are you?06:14
humphreybccould you commit what you have so far?06:14
nisshhno im just updating the wiki06:14
humphreybcokay but what about the actual chapter?06:15
nisshhill will commit some stiff in about 15-20 minutes06:15
nisshhstuff*06:15
humphreybccool. because we're really behind schedule, i'm going to email all the authors who are behind very soon and tell them to get some results or the chapters will be reassigned to other people06:15
nisshhyes ok.06:15
humphreybccool, thanks06:16
nisshhill give you a yell on here once iv committed06:16
humphreybcI don't want to sound mean or anything but I've been fairly nice and lenient so far, but now that we're getting to the business end of the project the results are lacking06:16
humphreybcThe achievements of an organization are the results of the combined effort of each individual.06:19
nisshhyea i understand i would have had it done sooner if not for all the hold ups in real life06:19
nisshhalso i wanted to ask you whether the current chapter 7 is too detailed or not enough detail06:20
nisshhiv had comments about both so im unsure which way to go06:21
nisshhand by what degree06:21
humphreybci'll have a look now06:21
humphreybcI think that's a good level of detail, i'm not sure whether we need a section on "browsing the file system" however. I am aware that I wrote down the original table of contents, but that was just as a rough guide06:23
humphreybcperhaps that can be incorporated into "useful commands" - it doesn't take long to tell people about cd mv cp rm commands06:23
nisshhgood point06:24
nisshhoh yea im going to download lucid and put it in virtualbox later too06:39
humphreybcneat06:44
humphreybcyou should try "Test Drive"06:44
humphreybchttp://launchpad.net/testdrive06:44
nisshhwhats that?06:44
* humphreybc just sent an email to the authors and CC'd to the team06:44
nisshhoh yea06:44
humphreybcIlyaHaykinson: check your inbox, I just sent an email to the authors/team06:46
godbykOoh, humphreybc's cracking the whip! :-)06:53
humphreybcindeed06:53
humphreybcnot on you though kevin!06:53
humphreybcyou're doing a stellar job06:53
* godbyk dances06:53
humphreybchaha06:53
humphreybcshame it can't be said about many of the authors though06:54
humphreybc(and yes I know that I haven't been a saint either! I still have to finish chapter 1)06:54
godbykMy part's pretty easy, though.  I'm not writing hundreds of lines of text.06:54
humphreybctrue. But it's possible, I mean just look at IlyaHaykinson's chapter06:54
humphreybche's written a tonne of stuff just by adding a little bit each day06:54
humphreybci mean we have more team members than the flippin' ubuntu docs team now06:55
humphreybcok wait we're a subteam of the ubuntu docs tea06:55
humphreybcteam*06:55
humphreybcso our team members add to their team06:56
humphreybcwe've practically doubles their number in that way hahaha06:56
godbykwow06:56
humphreybcyeah but it's still only the same 4 or 5 people uploading to the branch06:57
humphreybcyou, me, wolter, Ilya, joe and jamin every now and then06:57
nisshh*caugh* and me sometimes06:57
humphreybcthe translations are going well but we've got a bottleneck now where a lot of translators are waiting on more content from the authors. =S06:58
humphreybcnisshh are you keeping stuff locally before committing?06:58
nisshhyes im about to push some stuff now06:58
humphreybcoh great06:58
nisshhits not much just yet but theres more to come later06:59
humphreybcthat's good. will you have it completed by alpha? (remember, rough draft is all that's required for alpha)06:59
humphreybcoh and do you have a blog too?06:59
=== IlyaHaykinson1 is now known as IlyaHaykinson_
nisshhyes itll be done by alpha easily and no i dont have a blog07:00
humphreybcokay sweet :)07:01
godbykWell, this is pathetic: reddit is offline and I'm not quite sure what to do with myself.07:03
godbykI may have to actually do something constructive. :-/07:03
humphreybchaha07:04
nisshhlol07:04
godbykI really should start working on my dissertation one of these days..07:05
godbykMaybe I'll clean up my office.07:05
godbyk(Gah! See what I've been reduced to?!)07:05
nisshhhehe07:06
nisshhok iv pushed my changes07:10
humphreybcnisshh: cool07:10
nisshhjust give it a sec to update on LP07:10
humphreybceveryone, I've just replied to Thorsten's email about a whole bunch of design/style stuff. I CC'd to the list, as always. I'd appreciate some discussion from the team and feedback on mine (and his) suggestions07:10
nisshhok07:11
humphreybccool, mind if i give some feedback?07:13
nisshhnope go for it07:13
humphreybcokay so it's mainly niggly stuff07:14
humphreybcinstead of using linux, use "Ubuntu"07:14
humphreybcwe're trying to de-associate Linux and Ubuntu07:14
humphreybcLinux has many bad connotations07:14
humphreybcsee the style guide for more info on the reasoning behind that07:14
nisshhalso in LP fix committed is when the bugfix in in the main branch and fix released is when alpha release actually comes around07:14
humphreybcahh righto07:14
nisshhok good points07:15
nisshhany feedback on changes i just made07:15
humphreybcWindows should probably have a capital W, and is bash uppercase or all lowercase? I'm fairly sure it's lowercase... not 100% sure though07:15
nisshh?07:15
humphreybci don't think so no07:15
humphreybcalso it might be worth adding in "temporarily" to this sentence: "By using sudo, you can (temporarily) borrow these privilages...07:16
humphreybcand it might pay to mention the 15 minute sudo timer07:16
nisshhyes i thought of that but havent decided where to put it on yet07:17
humphreybcalthough that might be moving slightly into the security chapter07:17
nisshhin sorry07:17
nisshhis there a sudo section in the security chapter?07:17
nisshhbecause there should be07:17
humphreybcnope07:18
humphreybci don't think so07:18
humphreybcalso just explain that when the computer wants root privileges (ie, installing software etc) it will prompt you for your user password. Reiterate that this is _for the best_ otherwise people will (and do) liken it to Vista's UAC07:18
nisshhyes ok.07:19
IlyaHaykinson_maybe instead of root we can say whatever Ubuntu says?07:19
humphreybcso yeah, I think most of it is just making sure the user fully understands the permissions/sudo system in Ubuntu, what it means for them, and how it protects their system07:19
humphreybcbut other than that, cool07:19
humphreybckeep up the good work :)07:20
nisshhcheers im gonna make some more changes now07:21
humphreybcand it's probably better to commit anything you change instead of keeping it locally, that way we don't freak out when we see no progress being made when actually you've got it all on your computer :D07:21
humphreybcregarding the niggly things, technically they don't matter at the moment because it's the editors job to pick them up. And alpha is supposed to be just a draft. *But* I am a bit of a perfectionist, so I'm likely to pick up stuff like that07:21
IlyaHaykinson_nisshh: re your note at the bottom -- Currently: grep, uname, lspci, ifconfig and wget07:24
IlyaHaykinson_i think some of these are too obscure for a new user guide07:24
nisshhwhich ones?07:24
IlyaHaykinson_ifconfig (that's not even recommended anymore, you're supposed to use "ip addr list" i think)07:25
IlyaHaykinson_uname07:25
IlyaHaykinson_wget07:25
IlyaHaykinson_i think we need to teach people things like "ls" and "cd" and "mv" and "df" an d"ps"07:25
IlyaHaykinson_like totally elementary commands :)07:26
nisshhyes humphreybc and me were just talking abou that07:26
IlyaHaykinson_like see http://fosswire.com/post/2007/8/unixlinux-command-cheat-sheet/07:26
IlyaHaykinson_things that are on a cheat-sheet or otherwise show up in short new user references are the best, in my opinion07:26
nisshhalso pwd should be in there i think too07:26
IlyaHaykinson_yeah, those were just examples07:26
IlyaHaykinson_i think lspci doesn't really belong here.07:27
nisshhok07:27
IlyaHaykinson_maybe in some troubleshooting chapter or whatever, and even then only maybe :)07:27
nisshhill change that07:27
IlyaHaykinson_yeah. assume you're teaching this to a grandparent.07:27
nisshhyep07:27
IlyaHaykinson_sweet07:27
IlyaHaykinson_and thx for making progress. i totally appreciate this!07:28
IlyaHaykinson_also, i actually highly recommend putting up a wiki page with the chapter outline07:28
IlyaHaykinson_to the subsection level07:28
IlyaHaykinson_i find it much easier to organize thoughts that way, and also increase visibility of the chapter before it's written07:28
nisshhno problem07:29
nisshhi would have done so sooner but iv been extremely busy lately07:29
nisshhbut not so much now07:29
IlyaHaykinson_cool!07:29
nisshhyea, i havent even had time to work on my own project07:30
IlyaHaykinson_Does anyone know if there's a way for people who don't know bazaar to contribute, that's not "email documents to Ilya"?07:30
IlyaHaykinson_i've got a few writers who are just putting things together in open office...07:30
IlyaHaykinson_cause they don't feel familiar enough with bazaar...07:30
humphreybchave you tried bzr-gtk?07:30
nisshhhmm thats a problem07:31
humphreybcJamin has made a guide for it07:31
humphreybcand he was thinking using Lernid to teach new authors how to use it (he's got a slideshow etc all set up)07:31
humphreybcI had a chat to Jono Bacon and all we'd have to do was create our own "event"07:31
humphreybcperhaps "Ubuntu Manual Learning Day?"07:31
nisshhthey dont want to learn how this all works?07:32
IlyaHaykinson_humphreybc: hm, a slideshow etc may be nice.07:32
humphreybcIlyaHaykinson perhaps they could write it in openoffice/plain text and we could port it across to LaTeX in the meantime.07:32
IlyaHaykinson_yeha, that's what i was offering.07:32
nisshhwow, you just said what i was going to say07:32
IlyaHaykinson_but the guy wants to edit/post his own things07:32
humphreybcbzr isn't hard07:32
IlyaHaykinson_instead of routing it through me07:32
humphreybcbzr-gtk is even easier07:32
humphreybctalk to jamin about it, he can give you the slides etc on how to use bzr-gtk07:33
nisshhyea but they still have to learn latex and setup ssh and so on07:33
IlyaHaykinson_cool.07:33
humphreybctrue07:33
humphreybcssh?07:33
humphreybcwhat for?07:33
nisshhtoo much for a noob to handle07:33
IlyaHaykinson_or, better yet... i can offer to him to edit on some wiki subpage07:33
humphreybcWe have some fairly new users on the team at the moment and they're doing okay.07:33
humphreybcIlyaHaykinson that's a better idea07:33
nisshhbzr uses a protocol called bzr+ssh to push and pull to LP07:34
humphreybcAfter alpha we can hold a Learning day and get some of the main team members to hold sessions in lernid on stuff like style, latex code, editing, bzr etc07:34
humphreybcnisshh: but the end user doesn't need to know that? I don't even know that or use anything to do with ssh for bzr07:34
nisshhcool ill help out with that07:34
humphreybcbut right now we really need to get the content drafted07:35
nisshhhehe, do you have an ssh key on LP?07:35
IlyaHaykinson_ok, wiki it is for now.07:35
nisshhyep i agree07:35
humphreybcoh nisshh forgot about ssh keys07:36
humphreybci set mine up ages ago07:36
nisshhyea thats what i was refferring too07:36
nisshhsame but for a new user its a complex task07:36
humphreybcthat is true07:37
humphreybcwell after alpha we might have a bit more time to think about teaching new and current contributors07:38
humphreybcespecially since godbyk is doing so much work on latex that wasn't scheduled till beta!07:38
humphreybcall praise godbyk07:38
godbykheh07:39
IlyaHaykinson_is there a simple way to get a version of Lucid up in a virtual environment right now?07:39
nisshhoh, godbyk, your my hero!07:39
IlyaHaykinson_i have one that i manually installed, but i meant even simpler than that?07:39
nisshhnot really07:40
humphreybctest drive!07:40
humphreybchttp://launchpad.net/testdrive07:40
IlyaHaykinson_er, but that's for people who already have ubuntu?07:41
nisshhtestdrive is only available IN lucid07:41
IlyaHaykinson_i meant more like for ppl on windows or macos...07:41
nisshhnot when you first install it07:41
nisshhno one say wubi07:42
nisshhor ill virtually kick you07:42
nisshhin the face...07:42
IlyaHaykinson_*sigh* ok, i think i'll just patch up my virtualbox, zip it up, and give it to the writer in question07:42
nisshhcant he just download and run the iso through VB07:43
nisshh>07:43
nisshh?07:43
nisshhi pushed some more changes to LP too07:43
IlyaHaykinson_nisshh: i'm hoping to simplify things for her.07:44
IlyaHaykinson_and any other authors who may be good at technical writing, but not as good at linux07:44
humphreybchmm07:45
humphreybcyeah just export your vbox install, burn it to a DVD and wallah07:45
nisshhyea ok07:45
humphreybcI could ask for help in the forums or on omgubuntu.co.uk but i don't really want to give the impression to the public that we're struggling07:46
nisshhno you dont07:46
nisshhthat would be bad07:47
humphreybcexackery07:47
nisshhlol, is that a word?07:47
IlyaHaykinson_i think we don't need to ask for help in a "we're struggling" way, but instead more like "calling ubuntu users with writing experience to join the team" type of a thing07:47
humphreybchmm07:48
humphreybcwell I can talk to Joey from omgubuntu and ask him to do a wee blog07:48
nisshhyea, anyway im going to go eat something, and polish my car all probably push some more stuff to LP later tonight, cyas.07:49
humphreybcmartin can post a blog on Planet Ubuntu if I ask him07:49
humphreybcpolish your car? nice.07:49
nisshhyes i just painted it07:49
humphreybcoh wow, nice07:49
humphreybcwhat sort of car?07:49
nisshhcorolla07:49
nisshhtoyota07:49
humphreybcis it awesome?07:49
nisshhtotally!07:50
humphreybchaha07:50
nisshhhehe cyas then.07:50
humphreybcIlyaHaykinson_ :07:53
humphreybcdoctormo: Well no, I mean start by getting your people to write a blog post every day, get them to write about something that could go into their chapter and try and take an existing piece of writing and improve on it.07:53
humphreybc(20:52:10) humphreybc: but some more experienced authors would be a godsend07:53
humphreybc(20:52:39) doctormo: I can tell you now that there are no such people.07:53
humphreybc(20:53:03) doctormo: No technical writers who are willing to jump into writing. Either that or their already all in the docs team.07:53
humphreybc(20:53:13) doctormo: I know because learning team has been fishing for a while now.07:53
humphreybcblog posts sound like a good idea07:54
humphreybcto the planet07:54
humphreybcthen we can point newbies to the planet07:54
humphreybcfor the meantime anyway07:54
IlyaHaykinson_blog posts are nice...07:55
IlyaHaykinson_but i think actual chapter writing takes priority over getting ppl to set up blogs, adding them to the planet, etc.07:55
humphreybcindeed07:58
humphreybcbut for those that already have blogs and the planet07:58
humphreybcme, dutchie, you?07:58
humphreybcetc07:58
humphreybcwe could do that07:59
IlyaHaykinson_true.08:06
thorwilgood morning! :)08:20
humphreybchi thorwil, i sent you an email recently08:26
thorwilhumphreybc: just read it08:26
humphreybccool beans08:27
thorwilhumphreybc: would you be so kind and announce your decision regarding the design team on the list?08:28
humphreybcyup i can do that08:28
IlyaHaykinson_argh, i killed my vbox install of lucid. :(08:28
humphreybcdamn how'd you manage that?08:28
thorwilhumphreybc: i might send a mail regarding audience and so on to the list, and i think this will work better after an introduction08:29
humphreybcsure08:29
IlyaHaykinson_ah, wait. didn't kill it. just needed a hard reset08:29
humphreybcthorwil: current team members?08:30
humphreybc(of the design team)08:30
humphreybcand what's your full name thorwil?08:30
thorwilhumphreybc: vish and wolter said yes, no reply from kolorguild (David Nel), yet08:31
thorwilhumphreybc: Thorsten Wilms08:31
humphreybcthorwil: email sent08:32
thorwilty!08:32
thorwilhumphreybc: you have a one author per chapter policy?08:34
humphreybcnope08:34
* thorwil read Crunch time08:35
humphreybcI don't think I said one author per chapter08:35
thorwilno, you didn't. that's why i asked ;)08:36
humphreybcgotcha08:37
nisshhnisshh is back and hes awesome!08:45
nisshhhumphreybc: can you explain to me what this new planet thing is on your website, i dont really get what it does.08:46
IlyaHaykinson_virtualbox exports as .vmdk files?08:49
IlyaHaykinson_isn't that a vmware format?08:49
humphreybcnisshh: you know planet ubuntu right?08:59
nisshhyes08:59
humphreybcnisshh: do you play lacrosse by any chance?08:59
nisshhi have before09:00
humphreybchttp://en.wikipedia.org/wiki/Ryan_McNish09:00
humphreybcanyway, so Planet Ubuntu Manual is just our own version of Planet Ubuntu09:00
humphreybcit's hosted on dutchie's VPS and we're using my domain name09:00
nisshhright so you mean it sort of combines all those planet blogs together?09:01
humphreybcnope it just aggregates the blogs of a few of the manual people, like myself, dutchie, godbky etc09:01
humphreybcyou can see the list of people on the right09:01
humphreybcthat's why I asked if you had a blog09:01
humphreybcbrb getting junk food09:02
nisshhkk09:02
nisshhso all the posts at that domain name are from all the aggregated blogs?09:03
humphreybcyep09:28
nisshhare ok09:43
nisshhah09:43
nisshhnow i get it09:43
om26erHow can I help ubuntu manual project09:48
thorwilhi om26er. you might want to have a look at the "Contributions" section at https://wiki.ubuntu.com/ubuntu-manual09:50
om26erthanx thorwil09:51
thorwilwhere do i get ccicons.sty from?12:30
thorwili found a ccicons package, but no .sty in there12:35
thorwilgodbyk: hi! ^ ?12:35
godbykthorwil: Hey.12:35
godbykthorwil: The package is on the bzr repository already in the pkgs dir.12:35
godbykif you cd to the pkgs dir, you can run ./install-pkgs.sh and it'll take care if it for ya.12:36
thorwilgodbyk: ah, thanks. you might want to add that to https://wiki.ubuntu.com/ubuntu-manual/Help12:37
godbykthorwil: Ah, will do.12:38
thorwilgodbyk: afaik latex offers no help to achieve grid alignment? (i mean all baselines of all text being on the same heights on every page)12:39
godbykthorwil: Ugh.. LaTeX at its core is rather anti-grid.  But when I get around to designing the layout, it'll be semi-grid-based.12:39
godbyk(LaTeX has this concept of 'glue', which allows white space to stretch and shrink to best fit the page.)12:40
thorwilsounds scary12:41
godbykIt's pretty handy when you're using lots of mathematics and whatnot, but not so great when you're trying to typeset a non-math book on a grid.12:43
godbykI'm messing around with translations at the moment..12:52
godbykI think they're gonna be a bit of a pain.12:52
godbykEach language may have its own set of fonts.12:52
thorwilgodbyk: there seem to be 2 tones of red, "Ubuntu Philosophy" is darker than "The Ubuntu Promise"13:01
godbykEach of the section levels is a different color, and the red used to highlight the user input (for the time being) may also be a different shade.13:02
godbykI didn't pick the colors. That was before my time.13:02
godbykThey will probably change/disappear when I get around to redesigning the thing.13:02
thorwilgodbyk: hope so. this rather subtle color differences of items that are far away from each other look like a mistake13:04
godbykYeah, I'm not sure where the colors originated.13:04
godbykThey may have been randomly selected.13:04
thorwilgodbyk: the switch from serif for 1st level to sans and back to serifs for text seems a bit odd13:05
godbykyeah, selecting fonts is currently on the top of my list.13:05
godbykI'm trying to find some great fonts that are open and that support the languages we're translating to.13:05
thorwilgodbyk: guess that's limiting enough, so i will leave that to you ;)13:07
godbykgee, thanks!13:07
godbyk;-)13:07
godbykit's quite a challenge, unfortunately.13:07
godbykmost fonts seem to target only one or two scripts.13:08
godbykso we'll probably have different fonts for different languages.13:08
thorwilfun13:08
godbykloads13:08
godbykthey have to be open because if they're not, then only authors who have those fonts will be able to compile the pdf.13:09
thorwilgodbyk: i'd try to make the lowest level headline have the same size as body text (if that isn't already the case)13:09
thorwilgiven color and spacing, you don't even need bold there13:10
godbykyeah, that'll all change after I've found the typefaces.13:11
thorwilgodbyk: where do i have to look for the margins (including those for margin notes)?13:11
thorwilgodbyk: is the current page layout based on even divisions or proportions?13:12
godbykIn the ubuntu-manual.cls file, look for the \geometry commands.13:12
godbykthorwil: Yes, but the letter and A4 paper sizes are using completely different proportions for the margins.13:12
godbyk(And I'm not fond of either at the moment.)13:12
godbykThat'll be changing too.13:13
godbykBasically, everything's up for redesign. :-)13:13
thorwilgodbyk: good. i'd choose one system and apply it to both letter and a413:13
godbykWho was it that was going to print the title page a while back?  Did they ever report what their printer's margins were?13:14
godbykWe should probably figure out what those margins generally are so we make sure all our material falls inside them.13:15
godbyk(If we're expecting people to print this on their own printers.)13:15
thorwilgodbyk: i think it's between 4 and 10 mm, but yeah, i'll have a look f i find some official numbers13:17
thorwilgodbyk: what's marginparsep?13:20
godbykThat's the horizontal space between the margin notes and the main body text.13:21
godbykWell, I'm off to bed.  I'll probably be back on in 8-9 hours.13:28
maxolase1squadWhere is the current download?  I don't see it in the wiki.14:24
iantoAnyone here?17:19
iantoI'm writing for my chapter section and I'm wonder if it is possible to write a hyperlink to a previous section in the Installation chapter or would this break the formatting of the book?17:19
sebsebseb 19:05
dutchieianto: use the \chaplink or \ref commands20:18
pererik87Full disks mean no more PPAs, and no more uploads to PPAs. We’d like to add some more disks, but we can’t actually do that soon enough for a bunch of complicated reasons.21:59
pererik87Instead, we’ve decided that we’re going to remove all of the source files for any uploads that are:21:59
pererik87in PPAs21:59
pererik87not published, that is, deleted or superseded21:59
pererik87have been not published for over seven days21:59
pererik87Note that we already delete the binaries for such uploads.21:59
pererik87We are going to delete these old files this Wednesday, January 27th. We’re really sorry that we are announcing it so close to the actual event — we know it’s a hassle.21:59
pererik87qquote: launchpad21:59
* dutchie blinks21:59
dutchiepererik87: was that deliberate?22:02
pererik87wrong window:P22:08
dutchiethought as much22:08

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