*** replaceafill has quit IRC | 00:37 | |
*** menesis has joined #schooltool | 08:26 | |
*** menesis has quit IRC | 14:24 | |
*** menesis has joined #schooltool | 15:31 | |
*** mobert has joined #schooltool | 15:33 | |
*** yvl has quit IRC | 15:49 | |
*** replaceafill has joined #schooltool | 16:44 | |
replaceafill | th1a, i'm sorry but i'm still confused by this | 16:49 |
---|---|---|
replaceafill | what xls should i use to update dwelsh server? | 16:49 |
replaceafill | is the one i have the "official" one? | 16:50 |
th1a | replaceafill: This is what I have been trying to get everyone together on. | 16:52 |
th1a | I don't know which is which, they don't have numbers, they aren't in bzr... | 16:53 |
replaceafill | right | 16:53 |
replaceafill | i'll ask Glenda in my reply to David | 16:54 |
replaceafill | done | 16:56 |
th1a | mobert is working on updating the book & is going to be asking questions here. | 16:57 |
mobert | hey all | 16:57 |
mobert | It's my first day -- I've been on the clock since 8 a.m. | 16:58 |
replaceafill | should we set up a testing instance for mobert? | 16:58 |
mobert | I'm going to install 2.3 in a Virtualbox VM running Ubuntu 12.04 LTS | 16:59 |
replaceafill | ah! ok | 16:59 |
replaceafill | th1a, ok, now i'm waiting on aelkner :/ | 16:59 |
th1a | replaceafill: I got mobert's environment set up last week. | 17:00 |
replaceafill | ah, kk | 17:01 |
th1a | I supervised, I mean. ;-) | 17:01 |
mobert | I've already checked out the bzr repo for schooltool-book | 17:01 |
th1a | Watched him figure it out while offering gentle encouragement. | 17:01 |
replaceafill | :D | 17:01 |
mobert | and set up my own "junk" repo on Launchpad | 17:01 |
mobert | I just pushed the first commits an hour ago. | 17:02 |
mobert | https://code.launchpad.net/~matt-obert/+junk/schooltool-book | 17:02 |
mobert | install-toc.rst includes install-2_0 in the TOC tree, but the current installation candidates are 2.1 and 2.3 -- I'm not changing anything, but I wanted to confirm that's how it should be. (Is it?) | 17:04 |
mobert | I'm guessing that the 1.0 branch was the "pre-natty" documentation, which is no longer included in any toctree. | 17:05 |
th1a | Yes... you can prune that. | 17:06 |
th1a | Probably you should try to get Sphinx to not make any of those warnings. | 17:07 |
mobert | So as long as it's two-point-foo it should be written up in the install-2_0.rst -- we aren't going to make separate install-2_1, install-2_3, etc. | 17:07 |
th1a | Well... | 17:08 |
th1a | We don't want to do that. | 17:08 |
th1a | Probably you should go through this and figure out how it can be reorganized. | 17:08 |
th1a | It is a fairly important point, btw. | 17:08 |
th1a | So worth a little time. | 17:09 |
mobert | th1a: rm install-pre-natty.rst should silence that particular Sphinx warning ;-) | 17:09 |
th1a | Yes. | 17:09 |
th1a | I'm assuming you'll find the tidying to be vaguely satisfying for a limited period of time. | 17:10 |
th1a | You can re-name pages, combine them, etc. | 17:10 |
mobert | These are all the orphaned ReStructured Text source files: | 17:11 |
mobert | annual_reports.rst, email.rst, fedora.rst, grant-rfp.es.rst, history.rst, install.rst, install-pre-natty.rst, layout.rst, search-widget.rst, security.rst, translation-web.rst, vision.rst | 17:12 |
mobert | Should I throw 'em all on the bonfire, or try to update/revise some of them? | 17:13 |
th1a | Ah... no. | 17:14 |
th1a | I'll have to look at them. | 17:14 |
th1a | OK, so don't worry about that for the moment. | 17:14 |
th1a | In some cases they're landing pages for random external links. | 17:14 |
th1a | Part of your job is to just force me to think about this shit. | 17:15 |
mobert | Ah, landing pages, right -- gotcha. | 17:16 |
mobert | OK, I'm going to make a first pass through the existing site navigation, just following the "Next" links, and edit the pages just for spelling, grammar, and clarity -- the low-hanging fruit. If I have any questions, I'll ask them here. | 17:18 |
mobert | Then I'll install SchoolTool 2.3 and start playing with the example data. | 17:19 |
* mobert lurks ... | 17:19 | |
th1a | Yes. Make notes of things to look for like Apache & note the gaps. | 17:20 |
* mobert de-lurks! | 17:20 | |
mobert | OK | 17:20 |
mobert | Just to confirm: install-pre-natty.rst should definitely be pruned. | 17:21 |
th1a | Well... | 17:21 |
th1a | Probably what would be best is for you to go through the whole thing, and then make an outline or flow chart of how that section should work and we'll work from that. | 17:22 |
th1a | Rather than pushing around the existing pieces. | 17:22 |
th1a | Maybe literally a flow chart. | 17:22 |
th1a | Do you want to... | 17:22 |
th1a | Install? | 17:22 |
th1a | Upgrade? | 17:22 |
th1a | From... | 17:22 |
th1a | Pre 12.04? | 17:22 |
th1a | etc. | 17:22 |
mobert | OK, I won't delete any files yet, and I'll concentrate on the logical structure of the document. | 17:23 |
th1a | Particularly the installation knot. | 17:24 |
mobert | I'll make a note of any gaps in the documentation (like setting up Apache as an HTTPS proxy) as a list of tasks to return to later. | 17:24 |
mobert | I think I see where you're coming from. The site navigation flowchart will determine what *.rst files we end up with and how they are organized. | 17:26 |
mobert | The content will dictate the form, rather than vice-versa. | 17:26 |
mobert | Right, then -- back to work. | 17:28 |
* mobert lurks ... | 17:28 | |
th1a | Yes, basically I want fresh eyes to STOP the process of just twiddling those pages and shifing them around a little. | 17:28 |
*** khildin has joined #schooltool | 18:18 | |
*** ignas has joined #schooltool | 19:00 | |
* mobert de-lurks! | 19:08 | |
mobert | In the schooltool-book, it looks like source/upgrade-lucid.rst will need a complete rewrite. | 19:08 |
* mobert lurks ... | 19:09 | |
*** ignas has quit IRC | 20:05 | |
*** menesis has quit IRC | 20:31 | |
*** menesis has joined #schooltool | 21:26 | |
*** replaceafill has quit IRC | 23:38 |
Generated by irclog2html.py 2.15.1 by Marius Gedminas - find it at mg.pov.lt!