Your First Snap instructions break when adding Ubuntu package and re-running 'snapcraft stage'

[Jeff Lane ]

I'm working through the pretty awesome snapcraft documentation and found what seems to be a bug:
https://developer.ubuntu.com/en/snappy/build-apps/your-first-snap/

Note, this is a documentation issue, I just wasn't sure where to file that. It may also be a snapcraft issue, in that 'snapcraft stage' doesn't seem to work as described in the walk-through.

In the section called "Adding an Ubuntu dependency to a part" after we add the first part (the go webserver stuff) the instructions say to add the stage-package: directive and add fswebcam as an item to the snapcraft.yaml file.

Then it says:
Now let's stage our recipe again (and force it to go through the lifecycle).
$ snapcraft stage

On my Xenial system, this fails to add the fswebcam package. When I run that command, (Note I have followed the instructions exactly to this point), I get the following output:

$ snapcraft stage
Skipping pull cam (already ran)
Skipping build cam (already ran)
Skipping stage cam (already ran)

And there is no new addition to the ./stage directory. The walk-through says I should see several new dirs under ./stage.

I figured out finally that this worked if I did a 'snapcraft clean' to remove all the staged stuff, and THEN run snapcraft stage, which did pull the go webserver from github and the fswebcam package from the repos.

So it's a minor hiccup in the walk-though that can lead to some confusion when the example does not work as described.

ProblemType: Bug
DistroRelease: Ubuntu 16.04
Package: snapcraft 2.13.1
ProcVersionSignature: Ubuntu 4.4.0-31.50-generic 4.4.13
Uname: Linux 4.4.0-31-generic x86_64
NonfreeKernelModules: zfs zunicode zcommon znvpair zavl
ApportVersion: 2.20.1-0ubuntu2.1
Architecture: amd64
CurrentDesktop: Unity
Date: Wed Aug 3 17:06:03 2016
InstallationDate: Installed on 2016-02-11 (174 days ago)
InstallationMedia: Ubuntu 16.04 LTS "Xenial Xerus" - Alpha amd64 (20160210)
PackageArchitecture: all
SourcePackage: snapcraft
UpgradeStatus: No upgrade log present (probably fresh install)

[Sergio Schvezov (sergiusens)]

Should be working with 3.x