[20:35] <GunnarHj> jbicha: Are you around?
[20:39] <jbicha> GunnarHj: good evening
[20:39] <GunnarHj> jbicha: Hi!
[20:39] <GunnarHj> jbicha: I'm hesitating as regards the docs.
[20:41] <GunnarHj> 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] <GunnarHj> 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] <jbicha> 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] <GunnarHj> jbicha: Not sure I understand the significance of what you just wrote. Can you elaborate?
[20:47] <jbicha> GunnarHj: several apps link to the GNOME help, like nautilus: https://git.gnome.org/browse/nautilus/tree/src/nautilus-application.c#n778
[20:47] <jbicha> 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] <jbicha> 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] <GunnarHj> jbicha: Ok, that makes sense. We should probably not have both.
[20:53] <jbicha> 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] <jbicha> GunnarHj: have you looked at gnome-getting-started-docs? it's part of gnome-help too
[20:54] <jbicha> because it has videos, we split it into separate packages so that users only need the versions for their installed languages
[20:56] <GunnarHj> jbicha: No, I don't recall I've seen gnome-getting-started-docs. Is there a web version of it?
[20:56] <jbicha> GunnarHj: yes, it's the Getting Started section at the top of https://help.gnome.org/users/gnome-help/stable/
[20:58] <GunnarHj> jbicha: Ok... Is the .page files for that included in the gnome-user-docs package?
[20:58] <jbicha> (but the version on the website looks a bit old)
[20:58] <GunnarHj> jbicha: Or is it a separate package? (Suppose the latter.)
[20:59] <jbicha> it's a separate package but it embeds itself into gnome-help
[20:59] <jbicha> https://git.gnome.org/browse/gnome-getting-started-docs/tree/
[21:02] <GunnarHj> 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] <jbicha> I don't think publishing to help.ubuntu.com will be a problem
[21:04] <jbicha> Ubuntu customization can be handled a few different ways depending on how much you need to do
[21:04] <GunnarHj> 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] <jbicha> sure
[21:10] <GunnarHj> 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] <GunnarHj> jbicha: One thing which would complicate any customization is the translations. I have no idea yet how to handle that.
[21:23] <jbicha> 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] <GunnarHj> 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] <jbicha> oh, I guess it depends on how concerned we are about disk space
[21:32] <GunnarHj> jbicha: Precisely.
[21:33] <jbicha> the gnome-getting-started pkg is way too large to not be split into the language packs though (~116MB)
[21:37] <GunnarHj> 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] <jbicha> 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] <GunnarHj> jbicha: Right, that would be an option.
[22:34] <a1fa> gnome is so terrible
[22:34] <a1fa> even after million and one extensions to make it look like unity
[23:09] <a1fa> kde is.. so gross too