documentation-packages team mailing list archive

[Gunnar Hjalmarsson <1689321@xxxxxxxxxxxxxxxxxx>]

Public bug reported:

As of Ubuntu 17.10 the Ubuntu desktop guide will be made up of three
packages:

gnome-user-guide
gnome-getting-started-docs
ubuntu-docs

I have just set the NO_PKG_MANGLE variable in ubuntu-docs:

http://bazaar.launchpad.net/~ubuntu-core-doc/ubuntu-
docs/trunk/revision/651#debian/rules

It's desirable to avoid that the translated pages are stripped at build
time also for gnome-user-docs and gnome-getting-started-docs. Why? To
make it possible in practice to do docs SRUs. Language pack updates in
stable releases are made only for languages which have been successfully
tested, and since you never make all the translator teams accomplish the
required tests, the use of language packs would make docs SRUs result in
different docs contents for different languages.

Since gnome-user-docs and gnome-getting-started-docs are about to be
moved to main, I assume that NO_PKG_MANGLE should be set for them too.

The archive size of gnome-user-guide (including the translated pages) is
11 MiB. gnome-getting-started-docs is bigger, but OTOH it's already
split into language specific binaries:

gnome-getting-started-docs    (only English)
gnome-getting-started-docs-as (Assamese)
gnome-getting-started-docs-ca (Catalan)
etc.

(The archive size of ubuntu-docs has been reduced to 0.2 MiB including
the translated pages.)

** Affects: gnome-getting-started-docs (Ubuntu)
     Importance: High
         Status: New

** Affects: gnome-user-docs (Ubuntu)
     Importance: High
         Status: New

** Affects: ubuntu-docs (Ubuntu)
     Importance: High
         Status: Fix Released

** Also affects: gnome-getting-started-docs (Ubuntu)
   Importance: Undecided
       Status: New

** Also affects: ubuntu-docs (Ubuntu)
   Importance: Undecided
       Status: New

** Changed in: gnome-getting-started-docs (Ubuntu)
   Importance: Undecided => High

** Changed in: ubuntu-docs (Ubuntu)
   Importance: Undecided => High

** Changed in: ubuntu-docs (Ubuntu)
       Status: New => Fix Released

-- 
You received this bug notification because you are a member of
Documentation Packages, which is subscribed to ubuntu-docs in Ubuntu.
https://bugs.launchpad.net/bugs/1689321

Title:
  Keep the desktop docs away from the language packs

Status in gnome-getting-started-docs package in Ubuntu:
  New
Status in gnome-user-docs package in Ubuntu:
  New
Status in ubuntu-docs package in Ubuntu:
  Fix Released

Bug description:
  As of Ubuntu 17.10 the Ubuntu desktop guide will be made up of three
  packages:

  gnome-user-guide
  gnome-getting-started-docs
  ubuntu-docs

  I have just set the NO_PKG_MANGLE variable in ubuntu-docs:

  http://bazaar.launchpad.net/~ubuntu-core-doc/ubuntu-
  docs/trunk/revision/651#debian/rules

  It's desirable to avoid that the translated pages are stripped at
  build time also for gnome-user-docs and gnome-getting-started-docs.
  Why? To make it possible in practice to do docs SRUs. Language pack
  updates in stable releases are made only for languages which have been
  successfully tested, and since you never make all the translator teams
  accomplish the required tests, the use of language packs would make
  docs SRUs result in different docs contents for different languages.

  Since gnome-user-docs and gnome-getting-started-docs are about to be
  moved to main, I assume that NO_PKG_MANGLE should be set for them too.

  The archive size of gnome-user-guide (including the translated pages)
  is 11 MiB. gnome-getting-started-docs is bigger, but OTOH it's already
  split into language specific binaries:

  gnome-getting-started-docs    (only English)
  gnome-getting-started-docs-as (Assamese)
  gnome-getting-started-docs-ca (Catalan)
  etc.

  (The archive size of ubuntu-docs has been reduced to 0.2 MiB including
  the translated pages.)

To manage notifications about this bug go to:
https://bugs.launchpad.net/ubuntu/+source/gnome-getting-started-docs/+bug/1689321/+subscriptions