[Cosmo-dev] Cosmo URL Scheme

[Jared Rhine]

Travis Vachon wrote:
> ...it might be worthwhile to rethink the cosmo url scheme.

Yes, I'm for having this conversation now, though it's too big to sort out
all the issues and have a lock by 0.5.0.  It's important to the hosted
service to have stable URLs for at least sections of the Cosmo services, so
I've a sticky-note tracking that item: "stable URLs".  I suggest changing a
couple of things for 0.5.0 that seem to have easy consensus, then making
some more changes over the 0.6.0 cycle if additional things get sorted out.

> /pim - the cosmo pim application (formerly known as scooby)
> /console - the cosmo administrative interface (includes things like
> login, help, about, home directory browsing etc)
> 
> There are a couple problems with this scheme:

I agree; they seem to come out of the merge.  There is overlap in the
support functions like help and login functions.

> The big question I have is: do we want to think about this now? Or
> should we punt it and just stick with the current scheme?

It's probably better to leave it in place for 0.5.0, because it's easy to
miss a couple spots and have bugs.  And since we're not branching 0.5 yet,
any experiments should be kept out of trunk it seems until after the branch
or consensus on changes.

> To get things rolling, here's a very rough draft of what I might do if I
> were the only developer in the world:
> 
> /pim - the cosmo PIM ui

Yes.

> /admin - purely server admin related stuff (add/remove users, server
> status, future hosted service related features)

That's probably not a bad idea.  I generally wind up wanting to add admin
tree to web sites at least as they mature and putting in a directory will
make it easier to manage authentication. +1.  Should probably be fleshed out
before concluding it's big enough to be appropriate.

> /help (or /info?) - all help/information related pages (currently in
> help.jsp and about.jsp, but potentially more if help system is expanded)

/doc?  I like /help better than /info.

> /account (or something different?) - user account related stuff: login,
> home directory browsing,

I like having an /account, but not sure home directory browsing belongs
there.  I was thinking more like /pim, as the pim eventually grows to
encompass document management, etc.

> /error - error messages

I'm ambivalent.  I thought there was already an /error mapping, so what
would be different here?

> Suggestions are definitely welcome for any of these...

Also, /feed -> /atom and /home -> /dav.  Brian's mention elsewhere, but I'm
+1 on them.  I'm hoping to see the whole URL scheme in one place to look for
places to rationalize it before settling the URL namespace design eventually.

-- Jared