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

Bug #1217518 reported by Dustin Kirkland 
20
This bug affects 4 people
Affects Status Importance Assigned to Milestone
Juju Website
Fix Released
High
Unassigned
charmworld
Fix Released
High
Unassigned
juju-gui
Fix Released
High
Unassigned

Bug Description

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).

Revision history for this message
Dustin Kirkland  (kirkland) wrote :

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.

summary: - juju.ubuntu.com vs. jujucharms.com vs. manage.ubuntu.com
+ juju.ubuntu.com vs. jujucharms.com vs. manage.jujucharms.com
Revision history for this message
Richard Harding (rharding) wrote :

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.

Revision history for this message
John A Meinel (jameinel) wrote :

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.

Changed in juju-core:
importance: Undecided → High
status: New → Triaged
Revision history for this message
Luca Paulina (lucapaulina) wrote :

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.

Revision history for this message
Gary Poster (gary) wrote :

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.

Gary Poster (gary)
Changed in juju-gui:
status: New → Triaged
importance: Undecided → High
Curtis Hovey (sinzui)
affects: juju-core → charmworld
Changed in juju-website:
status: New → Triaged
importance: Undecided → High
Revision history for this message
Mike McCracken (mikemc) wrote :

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.

Revision history for this message
Richard Harding (rharding) wrote :

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.

Changed in juju-website:
status: Triaged → In Progress
Changed in charmworld:
status: Triaged → In Progress
Changed in juju-gui:
status: Triaged → In Progress
status: In Progress → Fix Released
Revision history for this message
Richard Harding (rharding) wrote :

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.

Changed in juju-website:
status: In Progress → Fix Released
Changed in charmworld:
status: In Progress → Fix Released
To post a comment you must log in.
This report contains Public information  
Everyone can see this information.

Other bug subscribers

Remote bug watches

Bug watches keep track of this bug in other bug trackers.