[00:22] wxl: http://tsimonq2.net/misc/Lubuntu%20Manual%20Spec.pdf [00:22] wxl: what do you think? [00:24] i like what i see tsimonq2 [00:24] you should basically go through each and every single icon [00:25] that said, i'd encourage you to look at things like languages [00:25] including how to change the system language and/or the keyboard language [00:25] yeah [00:25] I have that in there [00:25] you did? huh i missed it [00:25] yep missed it [00:25] page 4 [00:25] :P [00:26] troubleshooting section would be nice too [00:27] shoot I forgot about a "reporting bugs" section [00:27] yes [00:27] oh I forgot, one sec [00:27] OH [00:27] and where to get more help [00:27] Unit193: stgraber put queuebot in here, just so you know [00:27] oh yeah! [00:27] e.g. mailing list, irc, etc [00:27] yay queuebot [00:28] I thought he should know [00:30] wxl: when I talk about support, I should talk about being as specific as possible, etc. [00:30] yep [00:30] wxl: all the things we sort of learned but don't really come to mind on a daily basis [00:30] exactly [00:34] also, tsimonq2: good job [00:44] wxl: yeah that took me on and off 7 hours so... [00:44] :P [16:24] tsimonq2: good job on that outline. now get it on your repo and then post it on lubuntu-devel and talk about your plan. ask for input/help [16:27] wxl: get the PDF on the Manual repo? [16:31] tsimonq2: maybe in sphinx format? :) [16:31] that does have a section on how to contreibute to the manual right? [16:35] oh no actually [16:35] well in the spec ;) [16:39] there should be clear instructions [16:39] somewhere at least [16:41] alright one minute [16:41] it's reasonable to have a CONTRIBUTING file in the repo [16:41] if you do it in md and have screenshots that would be super duper ideal [16:41] that's another thing this manual should have. lots of screenshots. [16:42] but do it like code [16:42] wxl: "Would you like some text with your screenshots?" type of deal is still bad though :Lp [16:42] incremental improvement [16:42] i.e. do the text first [16:42] teward: yes yes dear :) [16:43] :P [16:43] wxl: that's the plan [16:43] tsimonq2: i figured as such, but it's worth saying [16:43] :) [16:45] wxl: what should I respond with if people say, "we already have a Lubuntu Manual" ? [16:45] wxl: it's managed under Bazaar, first big mistake :P [16:45] wxl: it's also really outdated [16:45] tsimonq2: i would merge anything relevant there into this project [16:46] tsimonq2: also, it should be documented on the wiki page [16:47] wxl: but the syntax on that Lubuntu manual is ugly :P [16:47] http://bazaar.launchpad.net/~lubuntu-wiki-docs/lubuntu-manual/trunk/view/head:/installation/installation.tex [16:47] eew [16:47] I don't even know how to read that... [16:47] wxl: did we ever *finish* a Lubuntu Manual? [16:48] lol tex file [16:48] what's a tex file? [16:49] PLEASE tell me it's an old format that's not used anymore... lol [16:49] the only person that i've ever known to actually put any time in a manual was lynorian [16:49] tex is a very legitimate format [16:49] unfortunately it's a little obtuse [16:50] yeah [16:50] wxl: so sticking with Sphinx is a good idea? [16:50] i think so [16:50] great [16:52] i do know that lynorian made a lot of contributions to that recently so it would be wise to use any of that content possible [16:52] ultimately sphinx and tex are SORT of similar [16:52] but sphinx is far more updated [16:52] wxl: if anything, instead of GitHub (although it could be used as a mirror of sorts and could accept pull requests on there as well), you could possibly add me as an admin of ~lubuntu-wiki-docs so I can just push the Git repo to Launchpad as well [16:52] wxl: your choice, do you want to wait? [16:52] i think that would be wise [16:52] for now, it's fine where it is [16:53] wxl: former or latter? [16:53] oh ok [16:54] wxl: I actually have the ability to push to LP, mind if I just use it as a mirror for now? [16:54] sure [16:54] most important thing is involve the community [16:54] awesome [16:55] then there will be multiple methods to make PRs, some people hate GitHub, some people hate Launchpad, it's the best of both worlds I think [16:55] you might want to look for info like https://stackoverflow.com/questions/725811/is-sphinx-better-than-latex-in-writing-manuals-books to make an argument about why we should switch to sphinx [16:56] https://www.varnish-cache.org/docs/2.1/phk/sphinx.html === pavlushka_ is now known as Guest47235 === Guest47235 is now known as pavlushka [22:11] yes restructered text is a lot easier than tex [22:11] I think only real reason to use tex is like complex math homework [22:16] Also even getting a pdf out of that manual was hard [22:18] tsimonq2, ^ [22:47] wxl: ^ [22:48] tsimonq2: ^ [22:48] lynorian: ^ [22:48] wxl: ok [22:48] XD [22:48] i used to use tex for math homework [22:49] well, note taking really [22:49] rofl [22:49] i'd make pdfs out of it [22:49] but tex requires a lot of moving parts [22:49] and free space for everything [22:50] `sudo apt-get install texlive-full --dry-run ` [22:51] *J* 7? [22:51] * wxl checks to see if J is close to S [22:52] wxl: ##tsimonq2 :P [22:52] oh jeez [22:53] did rafeal make the manual icon [22:55] lynorian: s/apt-get/apt/ [22:55] lynorian: yep