=== unifi [~ddundas@pool-70-17-61-105.pskn.east.verizon.net] has joined #ubuntu-doc [08:28] African greeting. Wet, wet, wet in Johannesburg === abelli [~abelli@host-84-222-38-31.cust-adsl.tiscali.it] has joined #ubuntu-doc [09:17] dry dry dry in cape town and on my way to the beach [09:18] so unfair.. [09:18] lucky bugger :-) [09:18] its snowy here === froud hates the snow [09:19] ah well ... the wind is not even blowing ... and that say something for cpt [09:19] hope the weather holds for me. only a few days till I get to Cape town [09:19] cpt=cape town?! [09:19] abelli, yes [09:19] They say this time of year is the best time to visit Cape town [09:19] froud, it should .. just bring us some of that rain ... [09:20] yes it is .... [09:20] are you both in Cpt Lug? [09:20] only i am so lucky ... froud is in jhb [09:21] abelli: if you mean am I subscribed, yes I am. Have I been to a CLUG meet, no [09:21] maskie: why? [09:22] lucky about the cpt part ... [09:22] So which beach you off too, the nudist beach, what's its name? [09:23] sandy bay and no .... of to melkbosstrand on the west coast [09:23] maskie, why dont we make a cultural exchange between btlug and clug? [09:23] i take the sun, you take the snow [09:23] if you do like skying it's the best place in the world [09:23] ...actually i dont [09:23] abelli: no way dude, za would not be za [09:24] i like my sun ... snow is fine for a week a year when i want to go skiing [09:24] in fact [09:24] you come here for i week.. [09:24] Afrikaans is such an expressive language milkbushbeach :-) [09:24] wooza [09:24] woza lapa [09:24] i cant go further [09:24] sorry [09:25] ..mm.. ok woza, not wooza [09:25] froud ... yes it is ... i am out of here ... beach is waiting .... [09:25] maskie: ciao [09:25] chow [09:25] bye [09:25] ..i come there for a month [09:25] froud: chow? is it a new kind of us missile? === froud pull the chair closer to the keyboard and stretches for the fresh cup of hot coffee. [09:26] froud: za coffee?! [09:26] Yeap :-) Hey, I am going back to hacking the prose [09:26] the quick guide needs love [09:27] abelli: svn up and do some work on Quick Guide [09:27] it's getting close to the 21 [09:27] mmm... good luck.. [09:27] im going back to capacitors to [09:27] o [09:28] cummon dude lend a hand here, capacitors are boring [09:28] yeah.. but if i do not pass exams.. [09:28] i won't make my way through winter safe n sound === froud remembers learning stuff like Ohms and Kerchoffs Laws a long time ago [09:29] kirchoff [09:29] KCL, KVL, Thevenin, [09:29] Norton.. [09:30] Ah yes, those dudes too. [09:30] Engineering school seems so far away in the past. I must be getting old [09:30] are you an engineer= [09:30] = [09:30] ? [09:30] yes [09:30] what kind? [09:30] that's my background [09:31] but I gave up on pulling wire long time ago [09:31] electrical? [09:31] now I just explain how things work :-) [09:31] yes electrical [09:32] my "electrotechnics" [<= is this inglisch] teacher, uses to say [09:32] "electronic engineers use voltages like 0.6 V.. [09:32] It helps to be technical when you are a writer, especially when you write on technical subjects [09:32] electronics [09:33] we electrican ones deal with 10.000V... and that kills [09:33] ". [09:33] she's a poet [09:33] mmm.. no ... i meant [09:33] Yes, I did electronics basics, but chose Heavy Current [09:33] I liked the shhhhhock of it [09:34] electrotechnics [09:34] I guess it can be a term [09:34] ive got an exam [electrotechnics] on thursday [09:34] and something about economy on friday.. [09:35] : i need to study [09:35] enjoy, boy am I glad I dont have to do exams anymore [09:35] doesn't mean I dont study [09:35] c ya [09:35] icoa [09:35] oaic [09:35] ciao === abelli [~abelli@host-84-222-38-31.cust-adsl.tiscali.it] has joined #ubuntu-doc === froud has to go for a few minutes. If Liz appears keep her here and try help her to get going. I will return soon. === Kotiro [~maori@203.87.27.63] has joined #ubuntu-doc [02:17] froud? === Liz nudges froud === Liz sits patiently to wait === enrico [~enrico@enrico.developer.debian] has joined #ubuntu-doc [02:33] Liz: [02:33] hi [02:33] sorry I had to go out unexpectedly [02:34] Liz: so what's got you stuck? [02:35] hi Liz! === froud waves to enrico === enrico waves at froud [02:37] Liz: we're here to help so let's get started [02:38] oh dear, I guess Liz is preoccupied with something else [02:38] hehe [02:38] im here..i wandered off to play nethack [02:38] for a change i havent died yet [02:38] Liz: you need to teach me about that! [02:38] hehe [02:38] Me 2 [02:38] (maybe this is not documentation related) [02:39] its pretty good..but if you stop playing it..or die..you gotta start again [02:39] its not..but anyway [02:39] its 12.39am here [02:39] so Liz what's got you stuck on the docs [02:39] but I tried some variant of it, and I thought that was not just really a rpg [02:39] how do i get them? [02:39] the docs that is [02:39] i tried that sv thing..i get an error [02:40] what error [02:40] let's start by typing svn [enter] [02:40] command not found [02:41] sudo apt-get install subversion [02:41] ok you need to install subversion [02:42] ok..installing [02:43] cool let us know when it is finished. In the interim where do you want to have your working copy of the source [02:44] should be somewhere in /home/liz/ [02:44] in a new terminal do cd ~ [02:44] yep..thats cool with me..ill just make a folder for it first..so i can link it to my desktop [02:44] no [02:44] dont do that [02:45] is your present working directory your home folder [02:45] yes [02:45] ok once subversion is installed [02:45] type svn [02:45] you should get [02:46] says svn help [02:46] cool [02:46] do svn checkout https://docteam.ubuntu.com/repos [ubuntu-docs] [02:47] where [ubuntu-docs] is the name of the folder you want [02:47] what folder do i want?.. [02:47] what folder do i need? [02:47] just call it ubuntu-docs [02:47] do like this [02:48] svn checkout https://docteam.ubuntu.com/repos/trunk ubuntu-docs [02:48] This will create a folder /ubuntu-docs/trunk inside which you will see it adding all the sources [02:49] its asking about the certificate information...reject, accept, temporarily or accept permanently [02:49] ill accept [02:49] accept [02:49] ok..i got a list of things going here [02:50] right now its up to images [02:50] cool it's adding (A) the files to the directory ubuntu-doc/trunk/ in your home folder [02:51] This is known as your Working Copy or WC for short [02:52] so this is what i work with?..all these? [02:52] Yes, your working copy [02:52] don't worry if you break something it is ok [02:52] but im assuming im not doing all of them...correct? [02:52] i just work on little bits that i can..right? [02:52] you cant break the server repos [02:53] patience [02:53] has it finished [02:53] nope..still on images [02:53] ok let's wait for it to finish, we will help you though the basics you need to know [02:54] when it is finished please do cd ubuntu-doc/trunk/ [02:54] ok..its just done takescreenshop.png [02:56] still doing images [02:57] it will take a few minutes, the first time is the worst [02:57] it needs to get a mirror copy of everything in the repos [02:57] yes..the pictures would be [02:57] after that it will only send and receive changes [02:57] so it becomes much easier [02:58] Liz: are you running Warty or Hoary [02:58] warty..initially..but i upgraded my dist earlier this week. [02:58] but it kinda screwed up a little [02:58] so i had to go back to using some of the warty stuff [02:58] so you are now on Hoary [02:59] actually..im not sure now [02:59] wait..let me check [03:00] warty..the amd kernel [03:00] ok its done [03:00] ok now you cd into ubuntu-doc/trunk/ [03:00] i have revision 538 [03:01] i dont have a trunk directory in there [03:01] ok what do you have [03:02] just lots of files and folders right [03:02] directories?..i have userguide [03:02] quickguide [03:02] libs [03:02] ok [03:02] images, housekeep, faqguide, debian, common, adminguide, abutbuntu [03:02] sorry..thats abtubuntu [03:02] and .svn [03:02] so your present working directory (pwd) is ubuntu-doc/ [03:03] yep [03:03] do svn up [03:03] I have commited a change [03:03] 539 [03:03] you will see it patch the quickguide [03:03] that's right [03:04] this is how you get the changes residing in the repos into your wc from now on [03:04] cool...i see it [03:04] OK [03:04] now what text editor are you happy using [03:05] VIM [03:05] gedit.. [03:05] or abiword [03:05] i dont have alot of experience with vim [03:05] but i can use it if need be [03:05] Ok [03:06] do gedit quickguide/quickguide.xml [03:06] this will open the quick guide xml src [03:07] yep..looking at it now [03:07] and the tages [03:07] OK that is Docbook XML you are looking at [03:07] Do you see the top bit colored pink [03:08] you mean the [03:08] ok that is called the xml-declaration [03:09] or the bit that says doctype book public ...blah [03:09] now this bit [03:09] "http://www.oasis-open.org/docbook/xml/4.3/docbookx.dtd" [ [03:09] [03:09] ok..mines purple...but yeah, i de it [03:09] %xinclude; [03:09] see it that is [03:09] [03:09] %globalent; [03:09] ] > [03:09] this is called the Document Type Declaration [03:10] Basically it says that this xml file must conform to the rules of the Docbook DTD version 4.3 [03:10] The document is a book [03:10] hence the root element is [03:11] Scroll down slowly, reading the names of the xml elements [03:12] what does it mean by this ---> FIXME: MISSING XINCLUDE CONTENT [03:13] ok i get that it says fixme..but whats an XINCLUDE comment? [03:13] the elements are a semantic nomenclature that defines the role of the text [03:13] OK we have used a standard called XInclude [03:13] xmlns:xi="http://www.w3.org/2001/XInclude"> [03:13] [03:13] [03:14] FIXME: MISSING XINCLUDE CONTENT [03:14] yes..i see that bit just before the bit i pasted [03:14] [03:14] [03:14] [03:14] Basically this piece of code fetches a specific piece of text from another xml doc [03:14] if it does not find it the it outputs the message FIXME: MISSING XINCLUDE CONTENT [03:14] this way we know if all our XIncludes are working [03:15] if they are then this code will be replaced by the xml instance to which it is pointing [03:15] if not we see FIXME: MISSING XINCLUDE CONTENT [03:15] ahhh..okie [03:16] OK I want you to edit some text. Find a para and type something [03:17] anything? [03:17] anything [03:17] the big brown fox [03:17] just write it inside an existing [03:18] dont write a novell, just a few words :-) [03:19] brb [03:19] done [03:19] When you are done, save [03:19] ok [03:19] now let's go back to that wicked terminal session [03:19] i also corrected a typo..heh [03:19] you should still be in ubuntu-doc/ [03:19] ok..terminal window [03:19] yep [03:20] cd quickguide/ [03:20] ok [03:20] svn diff quickguide.xml > quickguide.xml.diff [03:21] then do less quickguide.xml.diff [03:21] This is called a patch [03:21] it contains the changes you made [03:22] yes..im seeing that [03:22] when you're finished looking at that press 'q' to exit [03:22] Ok you now know how to add text and create a patch [03:23] if you send me or enrico the patch we will apply it [03:23] after we have applied it you see it next time you do svn up [03:23] so i send the whole file to you? [03:24] or does it just make a little patch for that bit..and that sends to you ? [03:24] you would send just the file named quickguide.xml.diff [03:24] i email the file? [03:24] yes, for now [03:24] rightio [03:24] one tick while i do that [03:24] we can then check the patch and add it to the repos [03:24] no not now [03:25] Do it in future when you are doing actual work [03:25] ahh..ok.. [03:25] OK let's say you did something wrong and you want to get back the version in the repos [03:25] just do svn revert quickguide.xml [03:27] This will eliminate all your changes in quickguide.xml and role the file back to the last known copy in the repos [03:27] Clear so far :-) [03:27] yep..im taking notes as we speak [03:28] OK you can also log the conversation [03:28] Where to start work? [03:28] yes i know..but i never do, cause im normally in too many irc channels [03:28] I suggest that you do editing of current text [03:29] hence..i take notes [03:29] ok [03:29] we use US Spelling [03:29] and punctuation [03:29] Liz: if you want to make a wiki page with the notes, that could be very useful to others [03:29] (or you can send the notes to me and I do the wiki page) [03:29] ahh..im from new zealand..we normally use UK english [03:30] so a period go inside inverted comma's when the last work is like "this." [03:30] last work?? [03:30] If you are not sure use the dictionary installed on ubuntu [03:31] point it ast Websters [03:31] it at [03:31] what last work [03:31] froud: you wrote 'when the last work is like "this."' [03:31] so a period go inside inverted comma's when the last work is like "this." <--last work..or do you mean last word? [03:32] oh my bad [03:32] last word [03:32] ahh..ok [03:32] chicago manual of style will help you with this tuff [03:32] ill try and follow the previous lot of writing anyway..or find something that shows me what i need to do [03:32] stuff [03:32] great [03:32] whats a chicago manual of style? [03:33] its not a known university style.. [03:33] that i know of [03:33] hey froud ! what's up? [03:33] we normally follow the harvard style [03:33] Chicago/Turabian style. The best reference resource is therefore The Chicago Manual of Style [03:34] http://www.chicagomanualofstyle.org/cmosfaq.html [03:34] sivang: beseder gaver [03:34] mieyanim [03:35] Liz: the best way to work is in small pieces and commit often [03:35] rightio [03:35] i have it written down [03:35] so take a section make edits and submit the patch [03:35] and ill get onto it tomorrow..if thats ok [03:35] its like 1.30am here [03:35] no worries [03:36] froud: ah everything's fine thank you, been doing some stuff here and there I wan to check out the new doc repository do you have the current URI ? [03:36] So for example you can take a sect1 do your edit then create a patch and send it to us by email [03:36] yes..i can do that froud [03:36] thank you [03:36] hey Liz, what sections are you going to work on of what book? [03:36] sivang: https://docteam.ubuntu.com/repos/trunk/ [03:37] right now sivang..no idea ..i only just got it..heh [03:37] Liz: we are focused on Quick Guide [03:37] thats what ill be looking at [03:37] the quickquide [03:37] Liz: if you can focus on that it would be a great help :-) [03:37] yep [03:37] ill update in the morning..to make sure i have the latest stuff [03:38] Yes [03:38] and then ill come to chat and work on it [03:38] froud: wow nice [03:38] Liz: it is good practice to update before you start work and before you create a patch [03:38] Liz: ah cool, don't worry, if you get too much docbook in your way, frod will upload your changes ;-) [03:39] Liz: next time I will teach you more about validation [03:39] but here's the basics [03:40] Liz: are you also a seasoned writer? [03:40] Liz: (like froud is) [03:40] we have a script in the root of your ubuntu-doc/ folder [03:41] sivang, no, this is my first time doing this [03:41] tho i have done instruction manuals while i was studying [03:42] enrico, please tell froud that ill be back later today..its getting close to 2am monday morning here..and i really need to go to bed === froud [~froud@ndn-165-139-163.telkomadsl.co.za] has joined #ubuntu-doc [03:42] wb froud [03:42] and goodnight [03:42] its getting up to 2am here..i really need to go to bed [03:43] froud: Liz told me she'll be back later today..its ting close to 2am monday morning there... and she really needs to go to bed [03:43] i will be back later today tho [03:43] Liz :) [03:43] as sivang said, dont worry too much about getting the markup right I will fix it [03:43] Liz: good night [03:43] goodnight guys [03:43] Liz: goodnight! [03:43] too slow [03:43] whewwwwww, that was heavy [03:57] sivang: can we expectsome patches from you soon? [03:59] sivang: yes, I want to see a mail with your name on ubuntu-commits! === froud thinks sivang is now ignoring us [04:01] anybody else lurking on the side. We are so close and the Quick Guide is going strong a bit of help from everyone and I am sure we can bring this in for the freeze. [04:01] enrico: I think the current quick guide is a good base to improve on [04:03] enrico: jeff is concerned about the tips though [04:03] enrico: he feels that it will be tough going to add tips everywhere before the freeze [04:04] I suggest we comment them and then uncomment them back again after we have tagged [04:04] when do you actually want to create the tag, by what date? [04:04] 21? [04:05] if we tag you will have to write the deb packaging so that it creates the packages from the tag [04:05] not the trunk [04:07] uhm... no need to: you just checkout the tagged version and build the packages from it [04:08] Oh yes, the paths are relative right? :_) [04:08] WRT the tips, we can leave them there: then some will have some tips and some won't but that's not too bad [04:08] everything is relative [04:08] ok [04:09] well I am off, b c'ing ya all later [04:18] froud: see you! === abelli [~abelli@host-84-222-38-31.cust-adsl.tiscali.it] has joined #ubuntu-doc === abelli [~abelli@host-84-222-38-31.cust-adsl.tiscali.it] has joined #ubuntu-doc === abelli [~abelli@host-84-222-38-31.cust-adsl.tiscali.it] has joined #ubuntu-doc === abelli [~abelli@host-84-222-38-31.cust-adsl.tiscali.it] has joined #ubuntu-doc === unifi [~ddundas@pool-70-17-61-105.pskn.east.verizon.net] has joined #ubuntu-doc