Merge lp:~dholbach/snapcraft/integrate-snappy-tutorials-build-snaps into lp:~snappy-dev/snapcraft/core

Proposed by Daniel Holbach
Status: Merged
Approved by: Sergio Schvezov
Approved revision: 262
Merged at revision: 255
Proposed branch: lp:~dholbach/snapcraft/integrate-snappy-tutorials-build-snaps
Merge into: lp:~snappy-dev/snapcraft/core
Diff against target: 86 lines (+33/-11)
2 files modified
docs/intro.md (+9/-6)
docs/your-first-snap.md (+24/-5)
To merge this branch: bzr merge lp:~dholbach/snapcraft/integrate-snappy-tutorials-build-snaps
Reviewer Review Type Date Requested Status
Sergio Schvezov Approve
Review via email: mp+276012@code.launchpad.net

Commit message

Integrate all relevant information from https://developer.ubuntu.com/snappy/tutorials/build-snaps/ so it will be easier to maintain the docs for us. Fixed some other small issues along the way.

To post a comment you must log in.
262. By Daniel Holbach

fix typo - thanks David Callé

Revision history for this message
Sergio Schvezov (sergiusens) wrote :

thanks!

review: Approve

Preview Diff

[H/L] Next/Prev Comment, [J/K] Next/Prev File, [N/P] Next/Prev Hunk
1=== modified file 'docs/intro.md'
2--- docs/intro.md 2015-10-22 14:14:28 +0000
3+++ docs/intro.md 2015-10-28 15:21:31 +0000
4@@ -63,9 +63,9 @@
5 under the `./stage` directory.
6
7 This `./stage` directory is useful for building outside code that isn't in the
8-`snapcraft.yaml` recipe against the snap contents. For example, you might build a
9-local project against the libraries in `./stage` by running
10-`snapcraft shell make`. Though in general, you are encouraged to add even local
11+`snapcraft.yaml` recipe against the snap contents. For example, you might
12+build a local project against the libraries in `./stage` by running `snapcraft
13+shell make`. Though in general, you are encouraged to add even local
14 projects to snapcraft.yaml with a local `source:` path.
15
16 ### Snap
17@@ -75,15 +75,18 @@
18 area which may include some development files not destined for your package.
19
20 The Snappy metadata information about your project will also now be placed in
21-`./snap/meta`.
22+`./snap/meta`. Snapcraft takes care of generating all the meta-data Snappy
23+expects. For a breakdown of what this is, have a look at our [Snappy developer
24+reference](https://developer.ubuntu.com/snappy/guides/packaging-format-apps/).
25
26 This `./snap` directory is useful for inspecting what is going into your snap
27 and to make any final post-processing on snapcraft's output.
28
29 ### Assemble
30
31-The final step builds a snap package out of the `snap` directory. This `.snap` file
32-can be uploaded to the Ubuntu Store and published directly to Snappy users.
33+The final step builds a snap package out of the `snap` directory. This `.snap`
34+file can be uploaded to the Ubuntu Store and published directly to Snappy
35+users.
36
37 # Next
38
39
40=== modified file 'docs/your-first-snap.md'
41--- docs/your-first-snap.md 2015-10-01 08:54:15 +0000
42+++ docs/your-first-snap.md 2015-10-28 15:21:31 +0000
43@@ -275,8 +275,8 @@
44 golang-static-http:
45 plugin: go
46 source: git://github.com/mikix/golang-static-http
47- fswebcam:
48- plugin: ubuntu
49+ stage-packages:
50+ - fswebcam
51 glue:
52 plugin: copy
53 files:
54@@ -300,10 +300,29 @@
55 cd snapcraft/examples
56
57 In `examples/` you can find a diverse set of examples which should help you
58-get started on your own projects.
59+get started on your own projects. To get a good overview of the snapcraft
60+features used in these examples, check out
61+[this article](snapcraft-advanced-features.md).
62
63 If you should have any more questions, ask us on
64
65 * `#snappy` on `irc.freenode.net` or
66- * the [snappy-app-devel](https://lists.ubuntu.com/mailman/listinfo/snappy-app-devel)
67- mailing list
68+ * the
69+ [snappy-app-devel](https://lists.ubuntu.com/mailman/listinfo/snappy-app-devel)
70+ mailing list.
71+ We recommend you subscribe to this mailing list where discussions around
72+ snap apps take place, this will keep you up to date with new capabilities
73+ for your snappy app, and best practices from fellow developers.
74+
75+### Publish your app to snappy users
76+
77+We'll be happy to help you on the mailing list to build a snappy package of
78+anything that you are interested in. Choose a good name for it, and you can
79+very easily share it in
80+[ubuntu myapps](https://myapps.developer.ubuntu.com/dev/click-apps/?format=snap)
81+where you go to share it with other snappy users.
82+
83+This is the same underlying hub that we use for Ubuntu phone apps, but
84+snappy is a new iteration of that system. It only takes minutes from time of
85+upload to being available to end users. The goal is to deliver your app
86+directly to users instantly — you push a new version, they get it.

Subscribers

People subscribed via source and target branches