Snap Documentation (page deprecated)

This is absolutely on our short-term plan to add - thanks for the +1!

1 Like

Are you open to including some of the proposed pages in this index? For example, I’d like to see the topic on registering your app name be included under “publishing”. Maybe in a sub topic “releasing your snap”.

Yes, definitely (although we’ll likely tweak those docs slightly).

I know there’s a lot to do, and we really need to get these missing pieces in place asap, but we’re trying to do so in a way that’s consistent with the docs as published (that’s also the only reason why this topic is currently read-only - we’re constantly discussing these changes internally).

I’m currently working on a small set of docs to provide some wider context around snapcraft.yaml and then I’ll move straight on to publishing.

What needs to be tweaked to those pages? Can we help?

Scriptlets should be in the index.

@degville https://docs.snapcraft.io/releasing-your-app/6795 should probably be included in the table of contents as the intro page for the store publishing process.

@noise thanks - and yes, you’re right. I’m actually making a few edits to that doc now before publishing it.

2 Likes

I want to translate the documentation for brazilian portuguese, but I do not find the documentation for download, I searched in github and it was moved here, I want to keep the original page translating only the texts.

@degville is it intentional to only have Maven and Gradle under this heading, or should Python and others be added?

1 Like

Should be “one of the”.

Separately, though, I think removing this paragraph would improve the page. What it says is already obvious if you can see the page layout. (And if you can’t, “look”, “below”, and “left” are non-sequiturs.)

The same goes for “Welcome to the home of…”: it’s redundant with the rest of the page, and especially the next two paragraphs.

Thank you for highlighting this - and thanks for your thoughts on those paragraphs. I think you make a good point about the second paragraph, in particular, and I’ll rework this to remove those references.