snapctl doesn't advertise that it's an internal tool

[ellie]

I am suggesting the snapctl package should advertise in some obvious way, when attempting to be used, that it's an internal tool.

Why:

When I searched the web tryingto find out how to start a snap package, I ended up on some snapcraft.io forum post that led me to snapctl. I tried to use snapctl start and was frustrated at the lack of documentation, not realizing it's an internal tool and that I should have used snap start instead.

(Historic note: this ticket description was updated, previously I confusedly complained I couldn't get snapctl to work)

[Oliver Grawert (ogra)]

the snapctl command is excluselive for internal use inside snap hooks in context of packaging.
for interaction from shell you need to use the snap command.
the documentation is correct here, snapctl should be covered in the packaging documentation though.

[ellie (et1234567)]

Ah, there is also "snap start kubelet" which I was supposed to use. My bad.

[ellie (et1234567)]

I wonder, would it help maybe to make snapctl announce more obviously that it's an internal tool, for people stumbling as clumsily through the snap universe as me? :-D unless that's super obvious to all other beginners that just try to launch a service

[Oliver Grawert (ogra)]

yeah, that would probably make sense, feel free to adjust bug title and summary accordingly and re-open :)

[ellie (et1234567)]

Ok, I updated the ticket in hopefully a useful way!

[Paweł Stołowski (stolowski)]

I think that is a sensible suggestion, thanks for pointing this out.