=== nisshh_linux is now known as nisshh === nisshh_linux is now known as nisshh [20:02] . [20:04] hello? [20:22] Hey, rickfosb. Something I forgot to mention when you're testing your stripped down makefile is that you need to remove all the auxiliary files between each test. [20:22] rickfosb: I think "rm -f *.{aux,log,dvi,pdf,out,toc,glo,idx,bbl,blg}" will catch them all, but I might have missed a couple. [20:25] godbyk -- probably did not do make clean; make each time... haven't played with it for a day or so [20:25] is that enought? or do we need the rm [20:26] I'm worrking on fixing some bugs dealing with translations of the lucid-e2 branch and that thought just struck me. Figured I'd best let you know before I forgot about it again. :) [20:26] I'm pretty confident that 'make clean' will rm all those files. [20:27] The command I gave you is one I have aliased to 'texclean' on my system since I'm always fiddling with tex files. [20:27] no problem; If we were to make changes to the makefile..., they would get a commit and push correct?? [20:27] Yep. [20:27] ok, I'll copy that string [20:28] I'd want us to test the changes thoroughly before we start changing the build process :) [20:30] Yeah. At some point I'd broken the lucid-e2 Makefile. I don't recall if it was just on my system or if it was the repositories copy. It's been working okay for me lately, so I'll pretend it's all good. :-) [20:30] smile [20:31] been there. Broke a major makefile onetime using a non-vi text editor that repaced all the tabs.... I thought I was going to have to fire someone (myself included) :)) [20:32] heh. [20:32] (now I have a love hate relationship with backup/restore) [20:32] I really should have a more stringent (read: any sort of) backup policy. [20:32] As it is, I end up just manually copying files about if I think they're important. Or relying on my source control systems for that. [20:33] I use a 16 gig memory stick, primarily to make a copy of my most important working files for 'work'... probably need to do a better job of saving files from the Natty box though. [20:36] rickfosb: any chance adding the basic bzr commands (branch, pull, merge, commit, push) and best practices (backup) to Author/Editor pages on ubuntu-manual.org? [20:38] yea, i'll talk with c7p about that off line.. (sending myself a note) [20:39] I'd also like to add those to the style guide at some point. [20:39] cool! === godbyk changed the topic of #ubuntu-manual to: Ubuntu Manual Project discussion | Meeting agenda: http://pad.ubuntu-uk.org/UMP-April-Meeting2 | Style Guide: http://files.ubuntu-manual.org/style-guide.pdf | Website: http://ubuntu-manual.org | Launchpad: https://launchpad.net/ubuntu-manual | IRC logs: http://irclogs.ubuntu.com [20:40] rickfosb. The Style Guide is a bzr project, so you could add that. [20:41] I'll pull that down. thanks ChrisWoollard [20:41] https://launchpad.net/ubuntu-manual-of-style [20:52] CrustyBarnacle: we do have a work in progress document for the bzr terminal commands: https://docs.google.com/document/d/1LDAyOVGMOLvsMTef3dTE3zt9q-gQY_-NetMKfZ6yM2Q/edit?hl=en&authkey=CLynx-cH [20:55] rickfosb: looks good [20:56] CrustyBarnacle: Like a said a work in progress. godbyk wrote the document; we could make it the source for a document on the manual site if needed. [20:57] brb [20:57] * ChrisWoollard looks for a power cable [20:59] * ChrisWoollard is back [21:02] evening c7p [21:03] hi ChrisWoollard and c7p [21:04] hello hannie [21:04] ChrisWoollard, hoe gaat het ? Long time no see [21:04] hello all, sorry for being late [21:05] Howdy [21:05] Someone holler at me whenever we're ready to start. [21:05] godbyk; go when you're ready [21:05] Ik ben goed [21:05] 'kay. Gimme just a sec. [21:06] how gaat het met jou? [21:06] s/how/hoe [21:06] ;) [21:06] ChrisWoollard, fantastisch / fantastic (lots of work to do ;)) [21:08] Okay, now that JasonO's here, we can get started. :-P [21:08] #startmeeting [21:08] Meeting started at 15:08. The chair is godbyk. [21:08] Commands Available: [TOPIC], [IDEA], [ACTION], [AGREED], [LINK], [VOTE] [21:08] [TOPIC] Screenshot resolution update [21:08] New Topic: Screenshot resolution update [21:08] c7p1? [21:08] Hello everyone. [21:09] yeah, actually this agenda item is from the previous meeting agenda [21:09] Oh, the meeting agenda is at http://pad.ubuntu-uk.org/UMP-April-Meeting2 for anyone who wants to follow along. [21:09] Hello JasonO [21:09] c7p1: We're off to a good start, then! :-) [21:09] Hi hannie [21:09] c7p1: Is there anything that needs to be discussed at this meeting about screenshot resolutions then? [21:10] you had a conversation about the screenshot size, and there were some members of the team that wanted to check 800X600 resolutions vs the current [21:10] c7p1: Did we determine to leave the resolution 'as is' in the current manual? [21:11] Another option might be to restrict the width of the screenshots to the main text block width (instead of the full page width). [21:11] I believe current is 1024x768 [21:12] godbyk: Agreed [21:13] I took a look at a couple of images and I think either would work; so if restricting to main text block width is the way to go..., then no changes? [21:13] * IlyaHaykinson waves [21:13] i guess so, if there aren't any disagreements [21:13] hey Ilya :) [21:14] I can build the maverick manual with screenshots thave a max width of the text block so we can see what it looks like. I'll do that after the meeting and email a link (or add it to the minutes). [21:14] Hey, Ilya. [21:14] godbyk: thanks. [21:14] godbyk: sounds great, thanks. [21:15] Okey doke. [21:15] moving on? [21:15] Anything else to say on screenshot resolution/size? [21:15] not from me [21:15] [TOPIC] Maverick edition: What's left to do? [21:15] New Topic: Maverick edition: What's left to do? [21:16] rickfosb? [21:16] The next few were originally mine. I wanted to try to wrap up 10.10 so that the translations teams can begin work. [21:16] I am editting prefs-hardware at the moment ;) [21:16] So, question is. What's left to do so we can determine a 'freeze'.. [21:17] Any editing left to do without owners? [21:17] And, I'm working my way through the document, but you guys have a good handle on most of it. [21:18] I think at this point we're down to just some copy editing. [21:18] rickfosb, do you know if there are translation teams that are going to translate maverick? [21:18] Agreed. [21:18] And copy editing could continue on forever, so we should probably just set a (reasonable) cut-off date. [21:18] I've gotten some unofficial requests [21:18] Should we set a deadline? [21:19] ChrisWoollard: I think we should draw a line in the sand and try for a cut off. [21:19] Is 30 days too soon? [21:19] or too much :) [21:19] is sooner possible? [21:19] i.e. 1 or 2 weeks? [21:19] How does two weeks sound? [21:20] I'm ok with two weeks. [21:20] i think the maverick version is pretty good now; i think two weeks is decent. [21:20] Okay. We'll set a string freeze date for 15 May, then. [21:20] How about just before the next meeting [21:20] Any objections? [21:20] ChrisWoollard: +1 [21:20] so it is frozen going into the meeting [21:21] I'll set it for 14 May, then in case our meeting lands on the Saturday. [21:21] :) [21:21] [ACTION] Maverick edition string freeze is 14 May. [21:21] ACTION received: Maverick edition string freeze is 14 May. [21:22] [TOPIC] Maverick edition: Should we leave Lucid edition credits or only include people that have worked on Maverick? [21:22] New Topic: Maverick edition: Should we leave Lucid edition credits or only include people that have worked on Maverick? [21:22] Ok [21:22] Maverick content is mostly/all based on Lucid, yes? [21:22] is was reviewing the credits. I wondered if you should only include people that have worked on maverick or eveybody [21:23] s/is/i [21:23] You guys would know how much has changed from lucid.. I would add the folks who've worked and leave the Lucid folks in. [21:23] I would say the authors section is the same [21:23] rickfosb: Agreed [21:23] but translators / editors will be different [21:23] I think the bulk of the original authors' work has remained. [21:24] And I agree that the translators and editors may be different. [21:24] Also what about the top section. [21:24] That has had a few changes [21:24] the top section is the one with Lead Tex / Project Lead etc in it [21:25] For the translators section, instead of listing all the translators from every language, I think we should list the translation editors and then list the individual translators in their translated edition. [21:25] why not have a "Current edition" credits section, and a "All contributors" section? [21:25] (Otherwise the translators list will be huge.) [21:25] godbyk: +1 [21:25] so anyone who ends up helping out in the current version goes in there, with the correct roles etc [21:25] and otherwise, people drop and remain forever in the All contributors section [21:25] Sounds good [21:26] One question I have (that we'll have to address at some point) is when do people fall off the credits list (if ever)? [21:26] good question [21:26] i would say they don't, unless their content is definitely not used any longer [21:26] Significant rewrite I would say [21:26] which is hard to prove [21:26] yes [21:26] That is difficult as we don't know what each has done [21:26] so make the font smaller, if we run out of room, or add a page, etc [21:27] oh. i say just list everyone in the past as a "contributor", without a role. [21:27] (The credits will start to look like the opening scene of Star Wars) :-) [21:27] we can have two credit sections something like: Previous contributors ... Current Manual Main Contributors [21:27] rickfosb: Or the closing credits of Star Wars! [21:27] (both! hah) [21:27] the All contributors section will be huge [21:27] More like the credits of a pixar film [21:28] lol [21:28] sorry i mentioned it :-) [21:28] So, can somebody summerise what we plan is? [21:28] What about a two year rolling window... stay in for two years and then move to the 'all' list? or is that difficult to maintain [21:29] So we want to have the current contributors at the top (with roles/titles) and the past contributors below (names only)? And we'll list the individual translators in their translated edition only. Translation editors can be listed in the English edition, though, I think. [21:29] rickfosb: So, does anyone ever fall off? [21:29] (four years,,, without further contribuitions, you could fall off) [21:29] ? [21:29] since we use Creative Commons Attribution–Share Alike License we can't remove previous authors. We can do so only if there is no material that they wrote right ? [21:30] Who is responsible for the Contributors pages? [21:30] godbyk: sound good [21:30] c7p1: Right. [21:30] hannie: Whoever we can sucker into maintaining it. :) [21:30] hannie: Ostensibly, that's one of the responsibilities that rickfosb holds as editor in chief. [21:30] No idea. I was looking at it, hence why i brought it up [21:30] it 'll be quite a job [21:31] But we'll have to help out right now as there's some history we have to take care of. [21:31] OK; I didn't assign it... was afraid toooooooo [21:31] lol [21:31] hopefully we have the doc with all authors and editors so the contributors page will be a matter of copy n paste :) [21:31] I'll take it on. And we'll figure out a format for keeping the license happy [21:31] I will make some changes to it [21:31] then we can review [21:32] I'm happy to reformat the credits, too. [21:32] (Thanks., I don't have the 'history') [21:32] We don't have to keep the same formatting (with the section headings, contributor roles, etc.) [21:32] Does that mean Rock, Paper ,Scissors [21:32] ChrisWoollard: I'll let you dive into it. You can holler at me if you want help with formatting/layout. [21:32] lizard, Spock [21:32] ok [21:32] Will do. [21:33] Going forward, we should try to be a bit better about tracking contributions. [21:33] agreed [21:33] I also feel like listing the contributors alphabeticllly [21:33] I'm sorting my email that way at the moment.... just so I can remind myself who asked for what. [21:33] ChrisWoolard: agree with Alpah [21:33] ChrisWoollard: I think I had them listed alphabetically at one point (excluding the leader roles). [21:34] *Alpha [21:34] That ordering may have been mangled as more names were added, though. [21:34] godbyk, i have a script that gets a list of contributors from bzr [21:34] ChrisWoollard, you mean alphabetic order within the sections? [21:34] ChrisWoollard: That's a good start. Though we have had some authors and editors in the past who didn't commit directly to bzr. [21:34] Comitters at least [21:34] hannie, yes [21:34] They'd submit their work to the chapter editor and let the editor deal with it. [21:34] Script?!?! its a SCORECARD :-) [21:35] rickfosb: Ha! So far, ChrisWoollard is winning. We'll have to fix that! [21:35] True, but it wasn't planning on indicating the scores, hense alphabetiacal [21:35] from now on, I fix one word at a time [21:35] (kidding) [21:35] heh [21:35] Okay, anything else we need to talk about wrt credits? [21:36] that was just luck. i only found out how to do that last week [21:36] nope [21:36] I'm done [21:36] 'kay. [21:36] [TOPIC] Natty edition: Chapter assignments [21:36] New Topic: Natty edition: Chapter assignments [21:36] rickfosb? [21:37] I've made assignments; Usually following up with an email to the folks involved. They are on the Authors and Editors pages. Do we need discussion? [21:37] Assume, we'll probably break big chapters up as needed. [21:37] here:https://spreadsheets.google.com/ccc?key=0Ar0Z6vOO38EydERxaWhGTkU2NTVDU2pxYXNHWWR1MlE&hl=en#gid=0 [21:38] rickfosb: Do we need more authors/editors for any chapters? [21:38] Or do we have good coverage? [21:39] in Lucid days, we had something like 80% of assigned people not contribute or contribute very minimally [21:39] Not having prior experience in the manual; I'm pressed to say. I suspect its the desktop sections that will need the most Authoring. [21:39] (Suspected that as well) [21:39] possibly because we didn't make the responsibility stick [21:39] so people felt ok not checking in [21:39] (including chapter editors) [21:40] which created a dilemma -- do we encourage the people to contribute (give them more time and chances), or yank the responsibility away and reassign [21:40] Would it be helpful to request/require regular status updates? [21:40] If we put a tentative time line out there today, then I will begin an email campaign... gently [21:40] I'll be talking with each; if someone drops out, I should know early enough [21:40] I wonder if it'd be useful to show some sort of graphical visualization that indicated which chapters were actively being worked on in the past (say) week. [21:41] godbyk: probably regular status updates could help. but perhaps more importantly, we need to clearly outline what happens if they don't contribute [21:41] so that there are no surprises [21:41] godbyk: that would be a great graphic!!! from bzr stats? [21:41] so like, if the chapter isn't making progress and we don't get a status update, we'll consider an author/editor no longer active and find someone else [21:41] i also had a LOT of authors last time who refused/couldn't learn bzr [21:41] Agreed [21:42] rickfosb: Yeah. I'm not sure if something like that exists or not, but it'd be interesting to see. [21:42] so i told them to contribute by text file emailed to me [21:42] even that didn't really work [21:42] I'd make that call at some point (no longer active) but its volunteer; i'll give them as much rope as I can afford. [21:42] IlyaHaykinson: sounds painful [21:42] I like the idea of a graphical status overview [21:42] We could also offer some bzr training (and latex training, etc.) if authors and editors are interested. [21:42] rickfosb: nod, i think if you're actively keeping an eye on each section's progress, we'll be ok. [21:43] so, to the next bullet: how long does this 'normally' take [21:43] it depends on how much needs to get written, right? [21:44] Around the Desktop will get completely gutted and redone [21:44] a few apps changed [21:44] all: this is a release that's getting a lot of press (some bad). I'd like to have a manual out there sooner rather than later. [21:44] but probably 80% of the manual is still as-is [21:44] 80% agreed as is [21:44] So we freeze 10.10.. and push hard on the 20% of 11.04 [21:44] my gut feeling for timeline is 10 weeks for active copywriting [21:45] rickfosb: Interestingly, the docs team is in the same boat as us. They're scrambling to get content written, too. [21:45] then 2-3 weeks for copyedit/screenshots [21:45] 90 days minimum - 120 max... [21:46] ? [21:46] I'm going to need a longer whip. ;-) [21:46] Can we set a review (alpha?) about 6-8wks out to gauge the progress? [21:47] How many authors are present at the moment? [21:47] yeah, it helped a lot, i think, to have milestones last time [21:47] we may let authors to tell their opinion [21:47] author/editor [21:47] I think the milestones were helpful as it forced everyone to come together for a soft deadline so we could assess our progress. [21:48] The two that have specifically asked for Desktop are Chen Lang and Dan Pullan... don't see them here? [21:49] [TOPIC] Natty edition: Timeline [21:49] New Topic: Natty edition: Timeline [21:49] I'll reach out to them tonight and ask for an initial content soft target(alpha) of 4 to 6 weeks and see if they freak [21:49] * godbyk isn't keeping up with the topics. MootBot will be angry! [21:49] i recommend something like: M1 -- lock down what needs to change, M2 -- all sections are in, at least with stub content, M3 -- copywriting down, M4 -- content freeze (copyediting / screenshots done), M5 -- release (final bug testing done) [21:50] That'll allow translations to commence at M4. [21:50] IlyaHaykinson: I like that. [21:50] i would decouple M5 from translation release [21:50] translations can commence at M4, but if they want to minimize change, they could wait for M5 [21:51] last time we had a lot of angry translators [21:51] IlyaHaykinson: Right. Translations are asynchronous with the English edition release cycle. [21:51] I've told some to standby until we get the branch built. that's M0? [21:51] IlyaHaykinson: yeah the bug tracking/fixing is a problem for translations, so M5 for translations [21:51] That's true. [21:51] we could also switch to a better translation tool [21:51] there was that open source one... poodle? [21:52] or soemthing [21:52] IlyaHaykinson: Any suggestions? I don't know enough about our options, but our current tools are not so great. [21:52] pootle [21:52] I think Poodle's roughly equivalent to Launchpad/Rosetta. [21:52] I'm not sure if it can handle our long strings any better. [21:52] May I ask what "M" means? [21:53] hannie: M = Milestone. [21:53] hannie: M1 = first milestone, M2 = second milestone, etc. [21:53] godbyk, thanks [21:54] Did we settle the timeline questions, then? [21:54] I have some milestone identified; I have the first alpha at 4 to 6 or 8 weeks.. I'll get that posted and begin working with content authors/ editors [21:55] rickfosb: M5 then is 90-120 days out from M0? [21:55] i would propose M0 = right after maverick release [21:55] CrustyBarnacle: Yeah. [21:55] M1 = 1 week [21:55] IlyaHaykinson: Agreed. [21:55] CrustyBarnacle: I hate time frame, but yes [21:55] M2 = week 5 [21:55] M3 = week 10 [21:56] M4 = week 13 [21:56] M5 = week 15 [21:56] I'll base the natty branch on the maverick branch. So I'd like to wait until maverick is as finalized as possible (so we don't have to port bug fixes from maverick to natty). [21:56] Yes; M0 should be after the freeze and that was when? [21:56] scrolling.... [21:56] rickfosb: We can always shorten the time frame if the content gets written more quickly. :) [21:57] rickfosb: Maverick string freeze is 14 May. [21:57] Right! 14 May [21:57] action on that? [21:57] M0 no later than 21 May [21:58] Is there a lot of difference between Lucid and Maverick? [21:58] hannie: Not too much. [21:58] The installation chapter was re-written [21:58] Plus shotwell was added [21:59] Question: Is Natty still too big for CD or was that fixed? [21:59] ChrisWoollard: Might be handy to look at the maverick bzr logs and note which chapters changed the most from lucid-e2. Could be helpful to the translators. [21:59] Its predecessor was removed. Whatever that was [21:59] actually authors can start working from now, natty is out. They can start writing content and when branch is up they can go on working with branches and other authors, right ? [21:59] (Installation section) [22:00] c7p1: agree, I'll suggest that to the desktop team [22:00] We can use podiff [22:00] ChrisWoollard: this only works for totally new sections. [22:00] hannie: We can certainly give it a shot. I've never tried podiff. [22:00] er, c7p1 [22:02] Moving right along... [22:02] [TOPIC] E-book formats [22:02] New Topic: E-book formats [22:02] We've had a few requests for alternative formats. [22:02] Who was trying to get a Kindle version? [22:02] These formats include web-based (HTML), a more accessible PDF, Kindle, Nook, and other e-book reader formats. [22:03] ChrisWoollard: I've had 2-3 people ask about a Kindle edition. [22:03] Has there ever been a survey on the use of certain formats? [22:04] why doesn't the current PDF work on the kindle? [22:04] i guess i can go check it out... [22:04] For the non-PDF formats, our best bet would be to use a different source format (such as Docbook) that allows conversion to multiple output formats. [22:04] No idea, i don't have a kindle [22:04] For the PDF formats, I can design the book to fit onto different screen sizes. [22:04] At the risk of being shunned..., ipad release [22:04] Kindle can open .mobi [22:04] IlyaHaykinson: thought I'd heard it was badly formatted (flow?) on the kindle. [22:05] ok, let me go test it [22:05] I can read pdf on the ipad; seems clean. [22:05] I *think* the Kindle tries to scale the entire PDF page to the screen, which makes the text too small to be readable. [22:05] But I haven't tried it myself. [22:06] godbyk: the request came from someone who was considering tinkering with the build? [22:06] rickfosb: I think the person who had suggested the tex4ht build option was different from the requester. [22:06] godbyk: All: sorry, i'm behind your comments... disregard [22:06] rickfosb: Ah, 'kay. :) [22:07] hm https://lists.launchpad.net/ubuntu-manual/msg02556.html [22:08] Action? [22:08] c7p1: The 'Simple Guide' he refers to uses OpenOffice.org as the source format. [22:08] So..... That was what i was going to say [22:08] Are we going to look at other versions for natty or natty+1 [22:09] i.e epub / mobi etc [22:09] I'd really like to look at other formats, yeah. [22:09] My view would be that IF we could make it transparent to our Author/Editor teams... then I'm ok. [22:09] I think that ultimately, we'll have to switch source formats, though. So that'll probably be something to hold off on until natty+1. [22:09] yes but on the last mail he says that he will research the whole thing (learn to use Latex etc) [22:09] Especially if we can tweak our build so that it builds the new formats when requested [22:10] action to push out to natty+1? [22:10] Otherwise, I would suggest that we look at other formats for LTS releases? [22:10] rickfosb: Well, we'd probably be switching the source format and that would affect the authors/editors. The build aspect would be transparent, though (aside from ensuring that the proper tools have been installed). [22:11] i think that any format change is probably too late to do now. [22:11] unless we think we can make the change in 3 weeks. [22:11] IlyaHaykinson: agree [22:11] otherwise, we risk having a serious delay on the natty manual as we fight with the new tools. [22:11] + the documentation that is needed for authors/editors [22:12] hence why we said natty+1 [22:12] IlyaHaykinson: I agree. I think we should hold off on the format change until natty+1 so we have time to work out the issues and ensure a smooth transition. [22:12] natty+1 = oneric ocelot [22:13] Having said all that, if I can generate a PDF that's more friendly to e-book readers and tablets, I'm willing to give that a try for natty. [22:13] and I thought narwhal was going to be difficult :)) [22:13] rickfosb: If you had any idea of the sorts of blue-sky plans we have... ;-) [22:14] I'm thinking we put it out on the ibooks store... that's blue sky.... ha [22:14] Another format request I had was for a large-print edition. (I think this request was from someone on the Lithuanian translation team.) [22:15] And that's something I'm willing to tackle. [22:15] that's the guru [22:15] What constitutes large format? Font size? Font Type? something else? [22:15] rickfosb: Font size mostly. [22:15] kay [22:16] The page layout will need to be adjusted a bit, too. [22:16] [TOPIC] Natty edition: Prologue introduction section [22:16] New Topic: Natty edition: Prologue introduction section [22:16] This topic was proposed by piratemurray. [22:16] I read his request; I also read the prologue this week. Not sure what would need to be added?? [22:16] He asks: How much of a rewrite do you want? Was thinking it is pretty good as is and will update for new happenings in Natty only. Thoughts on this? [22:16] I am fairly sure this chapter was editted a long time ago [22:17] ChrisWoolard: agree, could not find any copy edits. [22:17] I am also fairly sure it was me that did it ;) [22:17] ok, just tested on my kindle [22:17] the document looks good, but it certainly isn't optimal in terms of font size [22:17] everything is readable with good eyesight, including margins [22:17] and you can zoom [22:18] but that's not the normal kindle experience where you can easily control font sizing [22:18] still, we could fix this by increasing the font size a lot (2-3 times the current point size) [22:18] Do the margins need to stay? It's a lot of real estate to pay homage to the 'print' world? Just asking? [22:18] IlyaHaykinson: I've got a couple articles about using LaTeX to generate Kindle PDFs. I may play with it a bit and send you some PDFs to test out. [22:19] http://kindleformatting.com/ [22:19] LINK received: http://kindleformatting.com/ [22:19] rickfosb: good point. the margins could become in-line boxes or something [22:19] rickfosb: For the e-book versions, we could certainly reduce the margins. [22:19] ChrisWoollard: Thanks. [22:19] Is there anything else to say in regards to the prologue? [22:19] Inline box might be worth looking into [22:19] None here. [22:19] Okay. [22:19] yeah [22:20] rickfosb: Did we cover all your Natty milestone questions already? [22:20] I'll take an Action item to discuss with the pirate [22:20] Yes on Milestones [22:20] [TOPIC] Natty quick reference [22:20] New Topic: Natty quick reference [22:20] hannie? [22:20] I was just wondering if we can add such a list to the manual [22:21] a lot of things have moved to another place [22:21] Maybe we can list the old location and the new one on one page [22:21] Is this 'transition guide' something that you think should exist in the manual or as a separate document? [22:22] In the manual [22:22] Generally, I think our manual's target audience is for people who are new to Ubuntu. I wouldn't want to confuse people by references old releases of Ubuntu if we can avoid it. [22:22] What does everyone else think? [22:23] fyi -- here's our manual on the kindle: https://dl-web.dropbox.com/get/Public/IMG_20110501_141808.jpg?w=2c7ed2c7 [22:23] Aren't quick reference guides usually seperate documents? [22:23] I'm open to a Quick Reference page. We'd need to determine what needs to be there. [22:23] better link: http://dl.dropbox.com/u/4018722/IMG_20110501_141808.jpg [22:23] I do not see why you could not make it part of the manual [22:23] i think the quick reference page would be great [22:24] But if there is no need for it, ok. It was just a suggestion [22:24] given the "shortcuts" wallpaper recently featured all over, i think people clearly want one [22:24] Sounds more like an appendix to me [22:25] ChrisWoollard, I would see it as another "chapter" [22:25] or Index [22:25] or appendix if you want [22:25] people can look for the info that they are looking for on the proper Chapter, for example for the Unity they can check the "Ubuntu Desktop" chapter [22:25] but the point is, should we, or shouldn't we add it to the manual [22:26] yea, see the desktop section says it all; how to use ubuntu, where to get files, how to search... the new one will have to reference the dashboard... [22:26] but then you do not have a quick overview [22:27] So,... while i'm open to a quick reference... i'm thinking an addendum? [22:27] yes, addendum, appendix, whatever [22:27] rickfosb: +1 [22:27] We used to get cardboard help sheets for everything from Excel to Unix... maybe a page of those hints? [22:28] The most often needed 'clicks' [22:28] that's the idea [22:28] A sort of wheres my 'cheese' for natty [22:28] cheese is in the repo [22:29] godbyk: I'm thinking we get a page that could be http ready and include as a reference in the back? [22:29] rickfosb: We could do that, yeah. [22:29] Hannie: do you want the role? [22:29] There are also existing 'introduction to unity' guides that have been recently posted online. [22:30] rickfosb, I want to try [22:30] Comes under the heading; be careful what you ask for... :)) [22:30] jcastro wrote it i think? [22:30] Like this, for example: http://www.omgubuntu.co.uk/natty/ [22:30] yea, I'm thinking there are a couple out there... Benjamin had one too? [22:30] And another couple that were blog entries. [22:30] http://castrojo.tumblr.com/post/4795149014/the-power-users-guide-to-unity [22:30] LINK received: http://castrojo.tumblr.com/post/4795149014/the-power-users-guide-to-unity [22:31] rickfosb, let me do some research and I will send it to you, ok? [22:31] yep; Assuming we don't step on toes. [22:31] rickfosb that is Benjamin's. [22:31] but that is for powere users ;) [22:31] hannie: perfect! [22:31] I think there was a link or two posted to the Ubuntu Docs mailing list recently, too. [22:32] Let me see if I can scare those up real quick. [22:32] scare? [22:32] Josno0: thought so; he was even working out the Copy issues. [22:32] *Jason0 [22:32] If is currently licensed as a CC Sharealike 2.5 [22:33] godbyk: this http://doc.ubuntu.com/~mdke/natty/ ? [22:33] c7p1: I think that was one of 'em, yeah. [22:34] I'm not seeing the email. Maybe I imagined it. :) [22:34] What happened? [22:34] So the questions I have are: [22:34] 1. Do we want to write our own quick reference guide or just point to an existing one? [22:34] rickfosb Working on what? [22:35] 2. If we write our own, should it be part of the manual or a separate document? [22:35] Jason0; copyright language in the post... to insure all could reprint... as is [22:36] Jason0: seems like i have an email string on it somewhere. [22:36] 1. take what's available, 2. addendum [22:36] 1) i don't see the need of this section since the "Contents" section of the manual has a list with all the subjects that are covered on every chapter 2) if we decide to create one i think it's better to keep it on a separate doc or online [22:37] 2 [22:38] c7p1: I certainly want it on line [22:38] (and assuming we have to 'print' at some point, we may elect to keep it out of the print version) [22:39] one whole minute [22:40] I think that covers all the topics we had in the agenda. Is there anything else anyone would like to bring up? [22:40] Are we getting anywhere? THis meeting is now 1 hour 4 mins [22:40] 40 [22:40] [TOPIC] Any other business [22:40] New Topic: Any other business [22:40] How long should this meeting be? [22:41] :P [22:41] Sorry folks I put a long agenda together, but got my questions answered! [22:41] I had a meeting previous to this one which lasted 1 hour ;) [22:41] Our meetings usually run fairly long. :) [22:41] Okay, well, if there's nothing else pressing: [22:41] #endmeeting [22:41] Meeting finished at 16:41. [22:42] Thanks godbyk; job well done [22:42] Of course, you're all welcome to hang around and continue discussing things. [22:42] Thanks everybody [22:42] See you all, bye [22:42] Laters [22:42] Question for anyone; CD vs USB install... is Natty small enough to load via CD [22:43] I've been doing USB install for some time now.. and began to add text to the manual ... [22:43] there are ubuntu natty cd's so im guessing so ? [22:43] CDs... those are those shiny plastic things that people used to use for coasters, right? [22:43] OK; I recall that at one time, the image was too large [22:43] thank you all for coming :) good job godbyk [22:43] i think it's ok now, afaik [22:43] They also make good throwing stars.... [22:43] rickfosb I might want to be a writer. I will let you know. [22:44] JUst need Latex if that's what it's called? [22:44] Jason0: great email to rickfosb@gmail.com or to the 'list' and i'll pick it up. [22:44] Alright. [22:44] rickfosb: nattys not in the canonical shop, so...perhaps it's not. Idk if it's an indicator or not [22:45] ok folks, gonna go. bye [22:45] I think they should switch to DVD images instead, but I have cheap, plentiful bandwidth. [22:45] bye [22:45] OK; thinking we might need to rethink the install if teh live CD is really only a Live USB or DVD [22:45] Thanks all! [22:45] liveusb is faster so people would benefit more from that.. [22:46] ChrisWoollard: bye :) [22:46] all: bye [22:46] rickfosb: Their download page says "CD". [22:46] for what it's worth. [22:46] godbyk: got cha [22:47] so, did i miss the whole author assignment deal? [22:47] c7p1 Any adverts needed? [22:49] JasonO: I can't think of any yet, but we'll have some in a few weeks. [22:49] godbyk Thanks. [22:49] We have a string freeze on the maverick edition on 14 May, so we'll be releasing it soon after that. [22:49] Then we'll be frantically working on the natty edition. [22:50] JasonO: yes there aren't any, although it might be good if you could learn to use gimp or any other image manipulator program or even a video producer [22:51] c7p1 I know how to use Gimp. [22:51] neat then :) [22:51] And Istanbul. [22:52] bye all :) [22:52] G'bye, c7p1. [22:52] reading back through some of this conversation, if you are looking for great pdf output, there's nothing better than LaTeX. [22:53] unless you want to spend $1000 on Framemaker [22:53] By c7p1 [22:53] *BYe [22:53] i know LaTeX is kind of a pain, though [22:53] *bye [22:54] j1mc: For generating PDFs, I'd probably stick with LaTeX. [22:54] The issue we were discussing was how to generate other (non-PDF) formats. LaTeX isn't very good for that. [22:54] ah, ok [22:55] godbyk: are you familiar with pandoc? [22:55] So we'll probably want to switch to a different source format so we can get different output formats (like HTML, epub, etc.). [22:55] I'd still probably route it through LaTeX to generate PDFs, though. [22:55] j1mc: A bit. [22:55] Unfortunately, it doesn't truly understand LaTeX. It only has a superficial understanding of it. [22:56] And we're doing some non-standard things, so pandoc chokes on our .tex files. [22:56] yeah, it is more to output to pdf via latex, not really to import from it [22:56] j1mc: Have you been using Mallard much yet? [22:57] yes, for the 11.04 help [22:57] there is no pdf or epub output for it now, though. [22:57] From earlier discussions with Shaun and the Ubuntu Docs team, I got the impression that Mallard was probably not the way to go for a linear book and that Docbook would be better. [22:57] just on-disk (rendered by yelp) and html [22:57] Does this jive with what you know of Mallard? [22:58] yes... you can kind of bend it to work well with a book, but it's not what it is designed for. [22:58] Well, if it's XML I could probably transform it to TeX relatively easily (with XSLT or a script). [22:58] yes, perhaps. i'm sure Shaun would appreciate anyone who could look into that. [22:58] Mallard sounds great for topic-based help. [22:58] i need to step out [22:59] take it easy, godbyk [22:59] I've just been poking around to see what other formats are in use that could be easily translated to HTML, epub, TeX, etc. [22:59] j1mc: 'kay. See you later!