[16:31] le sigh [16:40] jbicha: I'm assuming were not going to be doing a raring series for doc? [16:40] jbicha: string freeze and all [16:42] bkerensa: well I could but nothing's changed in 5 months, people can just use the quantal branch [16:43] jbicha: yeah the only thing I could see benefiting is that if we had a raring series we could have proper version but other than that [16:44] jbicha: shutdown dialogs? [16:44] hmm? [16:44] jbicha: will we mention those in next release? [16:45] jbicha: we could update whats-new.page [16:47] bkerensa: yes you or someone else could do that, because we're past docs freeze you'll have to ask the translators but given that they don't have as much work to do this cycle anyway I expect it would be approved if it happens in the next couple of days [16:47] jbicha: I don't have commit [16:47] lol [16:47] and we don't have a series [16:47] if we had the series I could submit merges and get them reviewed [16:47] do you need a series? I don't believe we'll be doing more quantal updates? [16:48] true [16:48] so I can just pull the quantal branch and make the changes there yes? [16:48] since those wont go back to quantal? [16:48] ok let me make a series... [16:55] jbicha: thx [16:56] grabbing and getting to work now [16:59] ok, it's set up now, it will take a little bit of time for the translations to be imported into the raring series [17:02] jbicha: ok I will try and bug you tomorrow when I have some MP's lined up :) sorry I know your busy [17:06] translators need to finish their work by the morning of April 16 to make it on the release images [17:06] kk [17:07] jbicha: translations look to be imported in the raring branch [20:21] jbicha: Should I take some time to edit/proofread the ubuntu-docs raring or is it frozen for translation? [20:22] godbyk: uh you can ask for an exception [20:23] jbicha: Okay, I'll take a look at it and see if anything major needs updating. [22:01] godbyk: can you run it by me I am already working on getting some changes in [22:01] I would hate to see us do the same work :) [22:02] bkerensa: Sure thing. I was just going to skim through the docs and see if there was anything major out of place. [22:02] bkerensa: If we weren't beyond the doc freeze date already, I'd probably do a lot of minor editing as well. [22:03] bkerensa: What areas are you working on currently? Do you have a bzr branch I can follow? [22:03] godbyk: well I am updating all references to 12.10 and probably going to do some minor editing [22:04] godbyk: not yet.... I just had jbicha create the raring series earlier today so I have not gotten my first push in yet [22:04] bkerensa: If you're doing a bunch of minor editing already, could you also ensure that Launcher and Dash, for instance, are properly capitalized everywhere? They seem to be inconsistent at the moment. [22:05] bkerensa: Thanks for that, btw. I had brought up the lack of a raring branch last week but nothing happened. [22:05] I was beginning to wonder if there were going to be any 13.04 docs at all. [22:06] bkerensa: Have you stumbled across and docs/procedures for what needs to be done when the editing is complete? How are the final changes published (online and as system docs on the ISO image)? [22:08] godbyk: jbicha will have to review them since he can commit them to the branch then myself or he will need to ask the release team for an exception for the changes [22:08] godbyk: https://code.launchpad.net/~bkerensa/ubuntu-docs/raring/ [22:08] bkerensa: Okay. [22:08] that will be my branch [22:08] Thanks. [22:10] We'll also have to take the screenshots. There's a script that tries to automate that. [22:16] godbyk: do you know if that needs to be done in a VM? [22:16] godbyk: or a clean install at least? [22:16] bkerensa: I don't know that it needs to be, but it's probably easier if it is. [22:16] bkerensa: Definitely a clean install. [22:16] The script downloads a bunch of example files and will automatically adjust the screen resolution. [22:17] Then it'll start opening apps and windows and taking screenshots. [22:17] So I'd suggest running it under a VM with a fresh install. [22:17] I haven't found any docs for it yet, though, so there may be other setup-related stuff that needs to be done before running the script. [22:18] I asked Matthew East about it earlier today on the mailing list. We'll see if he has any pointers for us. [22:21] the screenshot script wasn't working quite right for quantal [22:22] jbicha: First MP pending ;p [22:22] jbicha: I will probably stage them bit by bit [22:24] bkerensa: I don't think that merge is particularly useful at this point [22:24] the 12.10 metadata is just when the files were last checked [22:25] jbicha: Is the autogen/make stuff still the proper way to build the system docs? [22:26] jbicha: yeah will be updating whats-new.page with some new stuff in 13.04 [22:26] other than that mostly just proof reading [22:26] bkerensa: you also changed cite dates, which isn't a good idea [22:26] oh [22:26] * bkerensa reverts [22:27] godbyk: probably, have you ever built a debian/ubuntu package? [22:27] jbicha: I've build lots of software before using autotools, yeah. [22:27] ok but have you built a package before? [22:28] jbicha: I've built a couple but it's been eons ago. [22:28] jbicha: So I'd have to have the manual or procedure in front of me to do it again. [22:29] ok you'll need to build the Ubuntu package as the final step, you can try http://developer.ubuntu.com/resources/tools/packaging/ [22:29] and if you need more help, you can ask in #ubuntu-motu or #ubuntu-devel [22:29] jbicha: I can build packages [22:29] ;) [22:30] jbicha: Okay, thanks. [22:30] after making string changes at this point in the release cycle, you'll need to run regenerate the translation template [22:31] I think that's as simple as running 'make pot' inside the ubuntu-help directory [22:31] jbicha: so should we just do the whats-new.page and leave version dates alone and proof read and push those minor changes? [22:32] jbicha: Will it cause a lot of churn for translators if we regenerate the .pot file each time? Are we better off waiting and regenerating the .pot file periodically? [22:32] bkerensa: yes, you can update the versions in the actual text too if they need it [22:32] godbyk: no I don't think so; otherwise it's even more work for them later on [22:32] you only have a couple days to make changes [22:33] since the translators are volunteers too, they need a full week to have a chance to do their thing [22:34] you don't necessarily need to update the pot after each commit but it doesn't make sense for the translators to translate stuff that's out of date [22:34] before making a release you'll have to download the translations and reintegrate those into the bzr branch [22:34] 'kay. [22:34] I think that is unforunately a manual process since LP uses different names for the files than our branch uses :( [22:35] jbicha: Yes. It's the same problem we have with the ubuntu-manual project. [22:37] ok good [22:38] jbicha: http://bazaar.launchpad.net/~bkerensa/ubuntu-docs/raring/revision/205 [22:38] Do you think I should mention the new shutdown dialogs? [22:41] bkerensa: that's up to you, I don't think they are harder to understand that what we had before though [22:41] ok [22:47] godbyk: I don't know what you use to rename the translations, but I wrote a note to myself in the README in lp:ubuntu-docs that might help [22:47] jbicha: I'll take a look at it. I have a one-line shell script that I wrote for the manual project. [22:51] jbicha: Are all of the .page files currently in use? Some of them fail validation. [22:55] yes, you can check ubuntu-help/Makefile.am to confirm but files shouldn't be named *.page if we aren't shipping them (rename them to .page.stub or something) [22:55] jbicha: Okay, I'll take a look at the validation issues next. [22:55] jbicha: I just submitted a simple merge proposal. [23:04] ok, I approved both of those and pushed [23:04] jbicha: Thanks. [23:04] I'll have to brush up on the Mallard docs a bit to fix these validation errors. [23:05] I'm not sure what elements are allowed where at the moment. [23:06] (You can run 'for i in *.page; do ./check_validation.sh $i; done' to see the list of validation errors.) [23:11] yeah the validator is a bit picky [23:11] obviously I haven't run it often enough [23:17] jbicha: When and how should the tag be updated? [23:20] whenever you want, you can use it to keep track of what pages need to be looked at and which you're marking as final for a release [23:20] see ./check_status.sh [23:21] I was playing with check_status.sh. that's what prompted my questions. [23:21] So the tag should reflect which version of Ubuntu/the package the page currently refers to? [23:22] it's an indicator of when the page was last touched [23:22] once the S cycle starts you might want to bump them all to 13.10 for instance [23:23] the ones currently marked outdated are good candidates to be looked at though, but probably next cycle [23:23] Should we bump them all to 13.04 now? Most of them are on 12.10. [23:23] Fair enough. [23:23] I know we're in a bit of a tough spot right now since we're so far behind. [23:23] I don't want to cause to much damage at this late date. :-) [23:23] you could, like bkerenesa suggested, but it didn't really improve things much to touch every file [23:24] it probably wouldn't hurt either though [23:24] jbicha: Well, just bumping the version number alone doesn't really do anything for us, it seems. [23:24] Is there a script that looks at the pkgname and version to see if that's still the latest? [23:24] If it's not the latest, it'd be good to know so we'd know that we need to review that page. [23:25] Once that page has been reviewed and updated for the latest version, that revision tag could be updated. [23:26] uh, no I don't think so, I believe the only scripts are the screenshot-collectors and the 4 in ubuntu-help/C/ [23:26] Okay. [23:26] I may look at writing such a script in the future. [23:26] cool [23:27] I probably won't be able to help with ubuntu-docs too much this cycle as I need to finish up the manual work first, but I can probably be more useful next cycle. [23:27] godbyk: have you contributed to ubuntu-docs before? [23:27] jbicha: Nope. [23:27] jbicha: The barrier to entry is fairly high and I didn't feel like jumping through all the hoops. [23:28] I'm not sure it's that much higher than the Manual and if it is, maybe you can fix that [23:29] Well, it's considerably higher than with the manual project. With the manual project, you just join the team and you can start committing code. [23:29] With the docs team, you have to fuss about with merge proposals and the like. [23:29] And the documentation for how to work with the docs code is outdated and scattered about. [23:30] And when someone does feel adventurous enough to ask on the ubuntu-docs mailing list, they get a somewhat canned response and a list of links thrown at them. [23:31] Ubuntu in general has a relatively high barrier for commit access and prefers to work with mp's [23:32] I was surprised at how quickly I was able to get commit rights to all of GNOME (but not release rights) [23:33] I can understand why, but it does add extra steps between 'doing some work' and 'seeing the results'. [23:33] With the manual, we've tried to be as open and non-restricted as possible. So far, we haven't encountered any problems. [23:33] There's been no vandalism or anything. [23:33] there's been talk about making a new packageset so the docs team can upload new release of ubuntu-docs, xubuntu-docs themselves without needing sponsorship [23:33] I keep an eye on all the commits so I can help out new contributors with syntax and style errors, but overall it works fairly well. [23:34] we might need a separate docs devel or release team for that then [23:34] Of course, the manual doesn't have to deal with packaging and releases like the docs do. [23:35] That might make sense.