PAGE DEPRECATED
This is the old table of contents page. It has been replaced with Snap Documentation .
The new page includes a table that maps each topic in the documentation to the final URL seen from docs.snapcraft.io , allowing us to fine-tune the URL without changing the topic title.
Welcome to the home of snap, snapd, and snapcraft documentation.
ⓘ Snaps are app packages for desktop, cloud and IoT that are easy to install, secure, cross-platform and dependency-free.
snap is both the command line interface and the application package format
snapd is the background service that manages and maintains your snaps
snapcraft is the command and the framework used to build your own snaps
Snap Store
Discovering snap:
Getting started Discover how snaps are used, installed, updated, removed and managed
Installing snap Step-by-step installation instructions for all major Linux distributions, from Arch to Zorin
Channels Get the latest stable releases of your favourite software, or run cutting edge versions
Advanced features:
Controlling updates Snaps update automatically, but you can also manually control when and how often
Snapshots Save, backup and restore the state of one or more installed snaps
Parallel installs Install more than one version of the same snap on your system
Building your own snaps:
Snapcraft overview Learn how to Install snapcraft and build your first snaps
Creating a snap Step-by-step guides for Python, Go, Electron, pre-built binaries and more
The snapcraft format A comprehensive look at the various values that can be defined within a snap’s build file
Most of this documentation can be collaboratively discussed and changed on the respective topic in the Snapcraft forum . See the documentation guidelines if you’d like to contribute.
3 Likes
Added a new Commands and aliases section.
1 Like
… and Service management.
1 Like
Could we pin this topic (the one with the navigation) to the top of the “doc” category?
I always arrive at https://forum.snapcraft.io/c/doc looking for it, can’t find it, and ultimately have to go to https://snapdocs.labix.org/ and click “the forum topic” in the footer to find it.
2 Likes
Would it be okay to add a <hr> (---in markdown) above the “Content” heading on this topic?
It would more clearly separate the introduction from the navigation for the user, and would make it easier for
1 Like
Good idea - I’ve been doing the same. Now pinned.
2 Likes
We can’t add that line because that content goes into the actual documentation header and welcome page. If we add a line here, a line gets added there. See page snapdocs.labix.org for a live (cached for 1h) snapshot of the content here.
Yep makes sense. We can tweak that after the new version lands.
Can you pin the first post in this thread instead of the 8th comment which is what you’ve got pinned right now? Oh well fudge, the forum does that automatically according to where it detected you’ve read down to. That’s helpful if you weren’t reading a page for documentation.
Just when is this documentation experiment, that has been thoroughly told to me isn’t an experiment anymore and is the only way we’re going to do things, going to replace the docs.snapcraft.io documentation???! Trying to remember the domain snapdocs.labix.org is a pain and rather impossible. Also it looks unprofessional when we point users there.
Thanks for the prod, and you’re absolutely right. We’re currently working on moving these docs over ASAP - even to the point of having daily meetings on the process. We can’t quite commit to a date yet, but we’re hoping the docs transfer will be soon.
2 Likes
@degville Could we please update the redirected links in the navigation to their new targets?
/t/configuration-options/87 -> /t/system-options/87
/t/enabling-swap-on-core/5440 -> /t/enabling-swap-on-ubuntu-core/5440
/t/permission-requests/455 -> /t/process-for-aliases-auto-connections-and-tracks/455
/t/tab-completion/2261 -> /t/tab-completion-for-snaps/2261
/t/mavin-plugin/4282 -> /t/the-maven-plugin/4282
Of if you could give me access to edit it myself, I’ll go ahead and do it.
@nottrobin I’ve just updated those links.
1 Like
Could someone with edit rights please update the “Interface management” link to point to /t/interface-management/6154 (the actual URL) instead of /t/interfaces/6154 (a redirect), to fix https://github.com/canonical-websites/docs.snapcraft.io/issues/51 ?
On a related topic, it would be great if someone could please give me permission to edit this page, so I can fix issues like this myself in future.
Updated, thanks for the prod.
1 Like
Is the page originally at https://docs.snapcraft.io/reference/env migrated to the new site?
I have ported this page to Environment variables , please help adding it to the new documentation site.
Also for Environment variables that Snapcraft exposes during the build process.
Please pin the following topic to Publishing > Snapcraft plugins
This plugin dumps the content from a specified source.
You can specify various details about such a source using source keywords , such as source and source-type.
This plugin uses also common plugin keywords .
Such keywords can, for example, be useful when the dumped content needs to be mangled or organised in some way. Using keywords such as filesets, stage, snap and organize can be useful in such cases.
For example:
parts:
my-part:
source: local-source/
plugin: dump
organize:
…
I would like to point out there’s no getting started documentation for snapcraft in the index
