bkerensale sigh16:31
bkerensajbicha: I'm assuming were not going to be doing a raring series for doc?16:40
bkerensajbicha: string freeze and all16:40
jbichabkerensa: well I could but nothing's changed in 5 months, people can just use the quantal branch16:42
bkerensajbicha: yeah the only thing I could see benefiting is that if we had a raring series we could have proper version but other than that16:43
bkerensajbicha: shutdown dialogs?16:44
bkerensajbicha: will we mention those in next release?16:44
bkerensajbicha: we could update whats-new.page16:45
jbichabkerensa: 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 days16:47
bkerensajbicha: I don't have commit16:47
bkerensaand we don't have a series16:47
bkerensaif we had the series I could submit merges and get them reviewed16:47
jbichado you need a series? I don't believe we'll be doing more quantal updates?16:47
bkerensaso I can just pull the quantal branch and make the changes there yes?16:48
bkerensasince those wont go back to quantal?16:48
jbichaok let me make a series...16:48
bkerensajbicha: thx16:55
bkerensagrabbing and getting to work now16:56
jbichaok, it's set up now, it will take a little bit of time for the translations to be imported into the raring series16:59
bkerensajbicha: ok I will try and bug you tomorrow when I have some MP's lined up :) sorry I know your busy17:02
jbichatranslators need to finish their work by the morning of April 16 to make it on the release images17:06
bkerensajbicha: translations look to be imported in the raring branch17:07
godbykjbicha: Should I take some time to edit/proofread the ubuntu-docs raring or is it frozen for translation?20:21
jbichagodbyk: uh you can ask for an exception20:22
godbykjbicha: Okay, I'll take a look at it and see if anything major needs updating.20:23
bkerensagodbyk: can you run it by me I am already working on getting some changes in22:01
bkerensaI would hate to see us do the same work :)22:01
godbykbkerensa: Sure thing. I was just going to skim through the docs and see if there was anything major out of place.22:02
godbykbkerensa: If we weren't beyond the doc freeze date already, I'd probably do a lot of minor editing as well.22:02
godbykbkerensa: What areas are you working on currently? Do you have a bzr branch I can follow?22:03
bkerensagodbyk: well I am updating all references to 12.10 and probably going to do some minor editing22:03
bkerensagodbyk: not yet.... I just had jbicha create the raring series earlier today so I have not gotten my first push in yet22:04
godbykbkerensa: 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:04
godbykbkerensa: Thanks for that, btw. I had brought up the lack of a raring branch last week but nothing happened.22:05
godbykI was beginning to wonder if there were going to be any 13.04 docs at all.22:05
godbykbkerensa: 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:06
bkerensagodbyk: 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 changes22:08
bkerensagodbyk: https://code.launchpad.net/~bkerensa/ubuntu-docs/raring/22:08
godbykbkerensa: Okay.22:08
bkerensathat will be my branch22:08
godbykWe'll also have to take the screenshots. There's a script that tries to automate that.22:10
bkerensagodbyk: do you know if that needs to be done in a VM?22:16
bkerensagodbyk: or a clean install at least?22:16
godbykbkerensa: I don't know that it needs to be, but it's probably easier if it is.22:16
godbykbkerensa: Definitely a clean install.22:16
godbykThe script downloads a bunch of example files and will automatically adjust the screen resolution.22:16
godbykThen it'll start opening apps and windows and taking screenshots.22:17
godbykSo I'd suggest running it under a VM with a fresh install.22:17
godbykI 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:17
godbykI asked Matthew East about it earlier today on the mailing list. We'll see if he has any pointers for us.22:18
jbichathe screenshot script wasn't working quite right for quantal22:21
bkerensajbicha: First MP pending ;p22:22
bkerensajbicha: I will probably stage them bit by bit22:22
jbichabkerensa: I don't think that merge is particularly useful at this point22:24
jbichathe 12.10 metadata is just when the files were last checked22:24
godbykjbicha: Is the autogen/make stuff still the proper way to build the system docs?22:25
bkerensajbicha: yeah will be updating whats-new.page with some new stuff in 13.0422:26
bkerensaother than that mostly just proof reading22:26
jbichabkerensa: you also changed cite dates, which isn't a good idea22:26
* bkerensa reverts22:26
jbichagodbyk: probably, have you ever built a debian/ubuntu package?22:27
godbykjbicha: I've build lots of software before using autotools, yeah.22:27
jbichaok but have you built a package before?22:27
godbykjbicha: I've built a couple but it's been eons ago.22:28
godbykjbicha: So I'd have to have the manual or procedure in front of me to do it again.22:28
jbichaok you'll need to build the Ubuntu package as the final step, you can try http://developer.ubuntu.com/resources/tools/packaging/22:29
jbichaand if you need more help, you can ask in #ubuntu-motu or #ubuntu-devel22:29
bkerensajbicha: I can build packages22:29
godbykjbicha: Okay, thanks.22:30
jbichaafter making string changes at this point in the release cycle, you'll need to run regenerate the translation template22:30
jbichaI think that's as simple as running 'make pot' inside the ubuntu-help directory22:31
bkerensajbicha: so should we just do the whats-new.page and leave version dates alone and proof read and push those minor changes?22:31
godbykjbicha: 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
jbichabkerensa: yes, you can update the versions in the actual text too if they need it22:32
jbichagodbyk: no I don't think so; otherwise it's even more work for them later on22:32
jbichayou only have a couple days to make changes22:32
jbichasince the translators are volunteers too, they need a full week to have a chance to do their thing22:33
jbichayou 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 date22:34
jbichabefore making a release you'll have to download the translations and reintegrate those into the bzr branch22:34
jbichaI think that is unforunately a manual process since LP uses different names for the files than our branch uses :(22:34
godbykjbicha: Yes. It's the same problem we have with the ubuntu-manual project.22:35
jbichaok good22:37
bkerensajbicha: http://bazaar.launchpad.net/~bkerensa/ubuntu-docs/raring/revision/20522:38
bkerensaDo you think I should mention the new shutdown dialogs?22:38
jbichabkerensa: that's up to you, I don't think they are harder to understand that what we had before though22:41
jbichagodbyk: 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 help22:47
godbykjbicha: I'll take a look at it. I have a one-line shell script that I wrote for the manual project.22:47
godbykjbicha: Are all of the .page files currently in use? Some of them fail validation.22:51
jbichayes, 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
godbykjbicha: Okay, I'll take a look at the validation issues next.22:55
godbykjbicha: I just submitted a simple merge proposal.22:55
jbichaok, I approved both of those and pushed23:04
godbykjbicha: Thanks.23:04
godbykI'll have to brush up on the Mallard docs a bit to fix these validation errors.23:04
godbykI'm not sure what elements are allowed where at the moment.23:05
godbyk(You can run 'for i in *.page; do ./check_validation.sh $i; done' to see the list of validation errors.)23:06
jbichayeah the validator is a bit picky23:11
jbichaobviously I haven't run it often enough23:11
godbykjbicha: When and how should the <revision> tag be updated?23:17
jbichawhenever 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 release23:20
jbichasee ./check_status.sh23:20
godbykI was playing with check_status.sh. that's what prompted my questions.23:21
godbykSo the <revision> tag should reflect which version of Ubuntu/the package the page currently refers to?23:21
jbichait's an indicator of when the page was last touched23:22
jbichaonce the S cycle starts you might want to bump them all to 13.10 for instance23:22
jbichathe ones currently marked outdated are good candidates to be looked at though, but probably next cycle23:23
godbykShould we bump them all to 13.04 now? Most of them are on 12.10.23:23
godbykFair enough.23:23
godbykI know we're in a bit of a tough spot right now since we're so far behind.23:23
godbykI don't want to cause to much damage at this late date. :-)23:23
jbichayou could, like bkerenesa suggested, but it didn't really improve things much to touch every file23:23
jbichait probably wouldn't hurt either though23:24
godbykjbicha: Well, just bumping the version number alone doesn't really do anything for us, it seems.23:24
godbykIs there a script that looks at the pkgname and version to see if that's still the latest?23:24
godbykIf it's not the latest, it'd be good to know so we'd know that we need to review that page.23:24
godbykOnce that page has been reviewed and updated for the latest version, that revision tag could be updated.23:25
jbichauh, no I don't think so, I believe the only scripts are the screenshot-collectors and the 4 in ubuntu-help/C/23:26
godbykI may look at writing such a script in the future.23:26
godbykI 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
jbichagodbyk: have you contributed to ubuntu-docs before?23:27
godbykjbicha: Nope.23:27
godbykjbicha: The barrier to entry is fairly high and I didn't feel like jumping through all the hoops.23:27
jbichaI'm not sure it's that much higher than the Manual and if it is, maybe you can fix that23:28
godbykWell, 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
godbykWith the docs team, you have to fuss about with merge proposals and the like.23:29
godbykAnd the documentation for how to work with the docs code is outdated and scattered about.23:29
godbykAnd 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:30
jbichaUbuntu in general has a relatively high barrier for commit access and prefers to work with mp's23:31
jbichaI was surprised at how quickly I was able to get commit rights to all of GNOME (but not release rights)23:32
godbykI can understand why, but it does add extra steps between 'doing some work' and 'seeing the results'.23:33
godbykWith the manual, we've tried to be as open and non-restricted as possible. So far, we haven't encountered any problems.23:33
godbykThere's been no vandalism or anything.23:33
jbichathere's been talk about making a new packageset so the docs team can upload new release of ubuntu-docs, xubuntu-docs themselves without needing sponsorship23:33
godbykI 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:33
jbichawe might need a separate docs devel or release team for that then23:34
godbykOf course, the manual doesn't have to deal with packaging and releases like the docs do.23:34
godbykThat might make sense.23:35

Generated by irclog2html.py 2.7 by Marius Gedminas - find it at mg.pov.lt!