charm-tools icon indicating copy to clipboard operation
charm-tools copied to clipboard

Install instructions on main repo page outdated

Open matthewhelmke opened this issue 7 years ago • 4 comments

Both here and on Launchpad, one of the first things a user who stops by will read are install instructions that use the PPA. Our official documentation has been changed to reflect the fact that the PPA has been deprecated as debs are no longer supported and snaps are their replacement.

Two issues, really: 1) we need to remove the PPAs from Launchpad and GitHub, and 2) we need snap install instructions for non-Xenial users to update our documentation as well as to finish the fix in part 1.

matthewhelmke avatar Feb 27 '17 13:02 matthewhelmke

Hello!

I've been trying to get started on charm development and have fairly good knowledge in programming. But due to the documentation being a bit weak, I can't really get a simple "get going" flow to work. Perhaps its me, but I can't find a good and consistent documentation that helps me get a basic, yet useful charm to build.

I think that juju seems very promising, but its fairly difficult to get going and contributing.

A clear example is that I fail on the very first step getting started developing from here: https://jujucharms.com/docs/stable/tools-charm-tools

When doing "snap install charm-tools" I get this:

> ubuntu@juju-cc088d-3:~$ sudo snap install charm
> error: snap "charm" requires classic or confinement override
> ubuntu@juju-cc088d-3:~$ 

So, for a first time visitor or charm developer - this is likely very traumatic.

erik78se avatar Apr 15 '17 09:04 erik78se

Add the --classic flag to the end. I will fix the instructions immediately!

On Sat, Apr 15, 2017, 05:05 Erik Lönroth [email protected] wrote:

Hello!

I've been trying to get started on charm development and have fairly good knowledge in programming. But due to the documentation being a bit weak, I can't really get a simple "get going" flow to work. Perhaps its me, but I can't find a good and consistent documentation that helps me get a basic, yet useful charm to build.

I think that juju seems very promising, but its fairly difficult to get going and contributing.

A clear example is that I fail on the very first step getting started developing from here: https://jujucharms.com/docs/stable/tools-charm-tools

When doing "snap install charm-tools" I get this:

ubuntu@juju-cc088d-3:~$ sudo snap install charm error: snap "charm" requires classic or confinement override ubuntu@juju-cc088d-3:~$

So, for a first time visitor or charm developer - this is likely very traumatic.

— You are receiving this because you are subscribed to this thread. Reply to this email directly, view it on GitHub https://github.com/juju/charm-tools/issues/306#issuecomment-294281432, or mute the thread https://github.com/notifications/unsubscribe-auth/AAET1bb9_C1AJrDJ4D67PHyqOQ8B1lrOks5rwIhugaJpZM4MNFBY .

marcoceppi avatar Apr 15 '17 13:04 marcoceppi

Hello @marcoceppi here is a tutorial I wrote to get started on juju development. It took me some calender time to get there, so I hope you find it useful and I'd love to get your feedback.

https://github.com/erik78se/juju/wiki/The-hello-world-charm

erik78se avatar Apr 20 '17 15:04 erik78se

  • The Juju docs page was fixed via https://github.com/juju/docs/issues/2092
  • The Tools GitHub page no longer mentions the PPA
  • The Tools Launchpad page continues to mention the PPA

pmatulis avatar Sep 20 '17 17:09 pmatulis