juju.ubuntu.com vs. jujucharms.com vs. manage.jujucharms.com

[Dustin Kirkland ]

Coming to Juju, and trying to follow all instructions, I'm really confused when I should be looking at:

 - juju.ubuntu.com (j.u.c)
 - jujucharms.com (j.c)
 - manage.jujucharms.com (m.j.c)

I started at j.u.c, because it looked the "most official". It has ubuntu.com in the name, so it must be the right site, right?

But j.c looks much fancier (albeit 10x slower to load).

And m.j.c seems to have the most information and the cleanest layout, but there's quite of bit of information I can't find there about setting up my Juju environment and using the juju commands.

I'd like to see a much cleaner layout of what documentation is where, and ideally, put ALL of this information under the same domain name, and just split it out into different top level directories (using a reverse proxy, if necessary to use different servers for the info).

[Dustin Kirkland  (kirkland)]

Filed against all 3 projects, as I'm not sure what's the appropriate home for this bug. Maybe there's more than one... Please triage as necessary.

[Richard Harding (rharding)]

It's a mix. The general idea is

juju.ubuntu.com - general info and docs
manage.jujucharms.com - for charm authors/charmers to make sure the thing is processed and to get information about errors, etc
jujucharms.com - an instance of Juju Gui for playing/testing out *using* charms to setup a deployment and exporting to replicate in your own environment.

[John A Meinel (jameinel)]

In talking with Mark Ramm this is an active work item this week. manage.jujucharms.com is intended to be hidden away/folded into just jujucharms.com. And this Friday is "documentation sprint day" to help do more work on juju.ubuntu.com docs, etc.

[Luca Paulina (lucapaulina)]

I'll add that a new redesigned Juju.Ubuntu.com is on the way. If all goes to plan then it should launch on Monday (2nd Sept) which should make the documentation more prominent and offer more concise information on Juju, please note that this is a 1.0 to get it up to a certain level where we can then improve it further in the coming months but it gives us a better foundation to start from.

[Gary Poster (gary)]

I'll also add two bits.

First, while Rick describes one future interpretation of manage.jujucharms.com, it is currently only intended as a tool for ~charmers (charm reviewers).

Second, we're talking about small and larger aspects of this. We'll hopefully have more concrete plans soon. For now, sure, the docs that John describes might be a reasonable start.

[Mike McCracken (mikemc)]

I was just confused by the difference between these sites -

I was trying to get to https://jujucharms.com/get-started , but misremembered the domain and typed http://juju.ubuntu.com/get-started , which redirects to https://juju.ubuntu.com/install/

jc.c/get-started and j.u.c/install present two different ways of getting started with juju - shouldn't there be just one way?
Or if both ways are important to present, at least one page that lists both ways and describes why you'd use each?

On looking through both, it looks like j.u.c/install is a bare 'how to download' page (with multiple platform info), while jc.c/get-started is more about how to start using juju (with only one platform).
I think they could be merged into one page, since jc.c/get-started starts with a "how to download" section.

[Richard Harding (rharding)]

Mike, thanks for the report. Wwe're actively working on this and you're landing in the middle of the transition. jujucharjs.com is a new site that will house all juju related material soon. We've got a deployment in the pipes that will move the Juju docs there, fix all the docs links to point to jujucharms.com, and help us continue work to port over any material left at juju.ubuntu.com.

As the material is converged we can work on cleaning up and reducing the duplicate content. It'll take time and we'll make sure your concerns are completely addressed as we make progress.

[Richard Harding (rharding)]

Marking the juju-gui target as fix released since it's been moved to demo.jujucharms.com and is not longer meant to be pointed to as the source for charm info. That's jujucharms.com's job now.