=== JanC_ is now known as JanC === ahoneybun_ is now known as ahoneybun === ricotz_ is now known as ricotz [20:35] jbicha: Are you around? [20:39] GunnarHj: good evening [20:39] jbicha: Hi! [20:39] jbicha: I'm hesitating as regards the docs. [20:41] jbicha: After I had replied on the docs list, I took a look at gnome-user-docs, and I saw nothing that would help us maintain publishing or customization. [20:42] jbicha: An alternative to switch to gnome-user-docs would be to copy all the .page files into the ubuntu-docs trunk, make the most obvious adjustments (and keep track of which those adjustments are). [20:44] I'm thinking you'd want to still identify as "gnome-help" so that we don't have to patch everything that links to help:gnome-help [20:45] jbicha: Not sure I understand the significance of what you just wrote. Can you elaborate? [20:47] GunnarHj: several apps link to the GNOME help, like nautilus: https://git.gnome.org/browse/nautilus/tree/src/nautilus-application.c#n778 [20:47] we patched some (but not all of them) to show help:ubuntu-help instead when run in Unity but that won't work any more [20:50] if gnome-user-docs and ubuntu-docs are basically the same except that the Ubuntu version is a bit better for Ubuntu users, then I don't think it is useful to have both in Ubuntu [20:52] jbicha: Ok, that makes sense. We should probably not have both. [20:53] the URI is set based on the install location, so to use help:gnome-help, you'd install to /usr/share/help/LANG/gnome-help/ instead of /ubuntu-help/ [20:54] GunnarHj: have you looked at gnome-getting-started-docs? it's part of gnome-help too [20:54] because it has videos, we split it into separate packages so that users only need the versions for their installed languages [20:56] jbicha: No, I don't recall I've seen gnome-getting-started-docs. Is there a web version of it? [20:56] GunnarHj: yes, it's the Getting Started section at the top of https://help.gnome.org/users/gnome-help/stable/ [20:58] jbicha: Ok... Is the .page files for that included in the gnome-user-docs package? [20:58] (but the version on the website looks a bit old) [20:58] jbicha: Or is it a separate package? (Suppose the latter.) [20:59] it's a separate package but it embeds itself into gnome-help [20:59] https://git.gnome.org/browse/gnome-getting-started-docs/tree/ [21:02] jbicha: Ok, there are quite a few things I'm not enough familiar with yet. My main concerns are 1. Ubuntu customization and 2. Publishing (branding) [21:03] I don't think publishing to help.ubuntu.com will be a problem [21:04] Ubuntu customization can be handled a few different ways depending on how much you need to do [21:04] jbicha: It needs to be dealt with somehow, and code for doing it is handy available in the ubuntu-docs package currently. Maybe that code can be copied, though... [21:05] sure [21:10] jbicha: I don't know yet how much customization would be needed. Currently there are a couple of obvious things, but to some extent it depends on some decisions which have not been made yet. Currently we have a pretty well working workflow with the docs for Ubuntu, and I think we should try to preserve it as much as possible to not alienate the community. [21:14] jbicha: One thing which would complicate any customization is the translations. I have no idea yet how to handle that. [21:23] I didn't understand the part in your email talking about translations, but I guess you can talk with seb128 about that later [21:28] jbicha: Yes, seb128 needs to be involved in that. My idea is to not use pkgstriptranslations when building, even if that's standard for main packages. [21:31] oh, I guess it depends on how concerned we are about disk space [21:32] jbicha: Precisely. [21:33] the gnome-getting-started pkg is way too large to not be split into the language packs though (~116MB) [21:37] jbicha: But splitting it the way it's currently done would not be a problem. I just want to avoid the language packs. [21:39] oh, maybe you could make a bunch of binary packages like the getting-started pkg does so it has the advantage of less disk space used but you should be able to update it on its own schedule [21:41] jbicha: Right, that would be an option. [22:34] gnome is so terrible [22:34] even after million and one extensions to make it look like unity [23:09] kde is.. so gross too