← Back to team overview

documentation-packages team mailing list archive

[Bug 1658785] Re: Snap documentation in 17.04?


Hi Will, could you give the Docs Team some guidance about what to say
about snaps in the the 17.04 desktop help? A user of the desktop help
will typically install and remove packages using Ubuntu Software (not
the command line). So as regards the desktop help I'm only concerned
about how snaps affect the GUI. My main concern is to avoid confusing
people who read the desktop help (which includes people who follow
procedures in the desktop help). As I understand it the sources of
possible confusion are:

1. Some packages are listed twice in Ubuntu Software (one is the snap
and one is the deb package). In such a case how does the user know which
to install? What do we say in the 17.04 desktop help?

2. When users try to install a snap via Ubuntu Software they get asked
to log on to Ubuntu One. The 16.10 desktop help documents installing
packages using Ubuntu Software but doesn't document log on to Ubuntu
One. What do we say in the 17.04 desktop help?

3. The 16.10 desktop help mentions that the Disks application lists
"hard disks, CD/DVD drives, and other physical devices", - I'm reading
this as meaning everything listed is a physical device - which is not
true any more since at present Disks lists snaps too. What do we say in
the 17.04 desktop help?

You received this bug notification because you are a member of
Documentation Packages, which is subscribed to ubuntu-docs in Ubuntu.

  Snap documentation in 17.04?

Status in ubuntu-docs package in Ubuntu:

Bug description:
  Do we say anything about snaps in the 17.04 desktop help and if so
  what do we say? If snaps are experimental and subject to change then
  perhaps we should say nothing? Below I give some points about snaps
  worth thinking about (as regards how we document them):

  The logon to Ubuntu One in Ubuntu Software when one tries to install a
  snap will surely create confusion. I saw one example on the #ubuntu
  channel where people were confused by it (with good reason in my
  opinion). At present you don't have to logon to Ubuntu One if you
  install a snap from the command line. Why are Ubuntu Software and the
  command line treated differently in this respect?

  I don't know much about snaps but in the manual for the snap command
  there are options to buy a snap and log on to the snap store. I would
  imagine that at present there are no snaps that one has to pay for -
  but there will be soon?

  Snaps are visible in the Disks application as "devices". This is very
  confusing in my opinion.

To manage notifications about this bug go to: