Software Store Help

[Matthew East]

Hi Matthew / Michael

I'd like to propose that the help for software-store be maintained by
the documentation team in the ubuntu-docs package.

The rationale for the change is as follows:

1. Translations of help can only be done by manually importing
translated po files from Launchpad and generating xml from them. That
exercise is carried out routinely for the ubuntu-docs package each
release, but doesn't tend to be done much for other packages which
contain help (with some notable exceptions). By way of example, the
manual for "Add/Remove..." has one translation (Swedish) whereas the
"Add/Remove Applications" document in the ubuntu-docs package has a
*lot* - https://translations.launchpad.net/ubuntu/karmic/+source/ubuntu-docs/+pots/add-applications.
I don't think the help for software-store is currently translatable
(correct me if I'm wrong) and I'd like to see that change.

2. The ubuntu-doc team is a good team to maintain documentation and
it's difficult to do so for separate packages as we would need to keep
track of the various documents that exist and maintain separate
branches for contributing to them. Having separate help is a good idea
for upstream projects but as far as I can see, software-store is only
for Ubuntu so it makes sense for the ubuntu-doc team to maintain its
documentation. We do this for jockey, and will soon be doing it for
usb-creator.

The change can be achieved pretty easily, I think. I'd suggest that
software-store point at ghelp:add-applications, and add a dependency
on ubuntu-docs. I am happy to undertake to update that document to
reflect the move to software-store in karmic and merge in information
from the existing software-store manual.

One point that would need addressing is the license. Currently it's
GNU/FDL, and it should ideally move to cc-by-sa 3.0 which is the
ubuntu-doc team's preferred license, and the license of the
ubuntu-docs package. It's also the Ubuntu project's preferred license
for non-code. That would require the consent of the three individuals
who have contributed to the document, if existing content is to be
merged with the ubuntu-docs package.

Let me know what you think.

-- 
Matthew East
http://www.mdke.org
gnupg pub 1024D/0E6B06FF