/srv/irclogs.ubuntu.com/2008/03/29/#ubuntu-doc.txt

ubotuNew bug: #73609 in ubuntu-docs (main) "monthly scrollkeeper cron job is very noisy" [Undecided,Fix released] https://launchpad.net/bugs/7360900:10
ubotuNew bug: #208763 in ubuntu-doc "Password and Encryption Guide mentions wrong location for program" [Undecided,New] https://launchpad.net/bugs/20876313:01
mdke /win 1214:39
sommermdke: hello17:52
sommermdke: there are a bunch of spelling mistakes I missed in the Server Guide, and I wanted to check with you about committing them?17:53
sommermdke: I haven't compiled a list yet, so I'll do that and let you know how big the impact will be17:53
sommermdke: there are 130 lines effected in the diff19:26
mdkesommer: that would seriously affect translators. are they literally just spelling mistakes?21:11
sommermdke: yep, spelling and capatilization of applications... on the whole they aren't that serious21:14
sommerreally most are capatilizations21:14
sommerI can send you the diff if you'd like to take a look21:15
mdkesommer: what we need to do is to ensure the translators don't get affected. We can do it by committing the fix right at the end of the cycle, after translations are already imported21:15
sommermdke: gotcha, it shouldn't affect the translations21:16
mdkedon't commit it for now, in case there are any more serious fixes which we need to apply and pass on to translators21:16
sommermdke: sure, I'll just hang onto it.21:16
sommerthe original diff was from another Server Team member that didn't have time to review before the freeze21:17
mdkeok21:17
sommermdke: thanks man21:18
mdkenp. Things are looking pretty good this release21:18
mdkethanks for all your hard work21:18
sommerya, there was still some things that didn't get documented, like iscsi, but that's because the development is still very active21:19
sommerI was thinking the other day about your comment concerning the size of the server guide, and I don't see it getting any smaller21:20
sommeris there another approach we should use for it?21:20
sommermaybe reorganize into sub-chapters or something?21:20
mdkesize in itself isn't a problem, as long as the whole guide is relevant to the server edition21:20
sommeryep, it's all relevant, I was just gatehering ideas for the next release, and so fare there are several good ones21:21
mdkeI was just a bit worried that sections might be being added which are not directly relevant - i thought perhaps that since jeos is its own "flavour", perhaps it should be in its own document, shipped with that flavour21:22
mdkebut you reassured me21:23
sommerah, yep I forgot that was the focus... that section may need some more thought, but I think for now it fits well21:23
sommerI was just thinking the other day that there is a bunch of scrolling necessary to see all the sections :-)21:24
mdkethat's true. you may want to consider reducing the number of sections21:26
sommerheh, that may be a tough sell, I was thinking to discuss the puropose/focus of the guide at UDS, that should then help figure out how to organize things21:28
mdkeI fancy you could save some space here and there21:32
mdkethe networking section looks like it might be able to house a couple of other sections21:32
mdkechapters 6 and 7, for example21:33
sommerya, chapter 6 is pretty small, but there are some ideas for additions to that chapter for the next release21:35
sommerlibnss-ldap, example client application configuration, etc21:36
mdkestructure doesn't depend upon size, it depends upon subject matter21:36
mdkeso if things are to do with networking, they should be in the networking section, even if they are huge ;)21:36
mdkeditto jeos and the virtualisation section21:37
sommerI'm with ya, but is there a way to display more than <sect1> tags in the main ToC?21:37
mdkeI don't completely understand your question, but I think the answer is "sure"21:38
mdkeah, you want deeper indexes?21:39
mdkeyes, that's easy. I think it would double the amount of scrolling required though21:39
mdkealso, normally the sect1 title is enough to tell you what is there, so it's a reasonable place to cut off21:40
sommerfor example the libvirt-virsh section, can that be linked to the main table of contents?21:40
sommerthe reason being is that it would make it easier to find specific content for what you're working on21:41
sommernot that it's terribly hard now21:41
mdkeI think the best way is to keep the index manageable and ensure that the sections are clearly enough titled that it's easy to find whatever you are looking for21:43
sommersure, that's what I was thinking as well21:44
* sommer wonders how hard it would be to add some type of live search21:45
mdkewhat to?21:48
sommerlike some blogs and other sites have, a little ajaxy live search field21:48
mdkeyou mean on help.u.c, the serverguide standalone html package, or yelp?21:52
sommerya the web site21:53
mdkeah21:54
mdkeyes, that would be good21:56
mdkeI still haven't given up hope with moving everything to the wiki and having a single website21:56
sommerfunny you should mention that, I was thinking the same thing last night :-)21:58
sommerat least for the server guide21:59
mdkethe docbook<->moin project is picking up again now so you never know21:59
sommerya, I did try it out for the bacula section, but the output was all continous22:00
mdkeyou can use the "tidy" program, I think I mentioned that before22:00
sommeroh, heh shoud've tried that22:00
sommerI'll bring the idea of moving to the wiki up at UDS and see what others think22:02
sommerat least the server guys22:02
mdkewell, I think it's only worth moving if everything moves22:02
mdkeno point having stuff in a different place22:02
sommerya, that's a good point22:03
sommerI'll do some more testing with the docbook > moin stuff22:03
sommerand moin > docbook... heh22:03

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