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