Naming for the Ubuntu Download Manager interface

Tue Jan 24 14:47:43 UTC 2017

I've submitted a branch for this here: 
 https://github.com/snapcore/snapd/pull/2694

Thanks!
 Mike

On Mon, 2017-01-23 at 15:23 -0200, Gustavo Niemeyer wrote:
> That'd be ideal, thanks!
> 
> On Mon, Jan 23, 2017 at 3:19 PM, Mike Sheldon <michael.sheldon at canoni
> cal.com> wrote:
> > Okay great, should I prepare a new branch that does the renaming?
> > 
> > On Mon, 2017-01-23 at 14:34 -0200, Gustavo Niemeyer wrote:
> > > Sounds good. If you think ubuntu-download-manager is the way to
> > go,
> > > let's move on with it.
> > >
> > > On Wed, Jan 18, 2017 at 2:34 PM, Mike Sheldon <michael.sheldon at ca
> > noni
> > > cal.com> wrote:
> > > > Ah, my mistake. I'd suspect UDM is less likely to change since
> > it's
> > > > already a public facing API being used in third party apps. But
> > it
> > > > sounds like we don't lose anything if we start it off as
> > unity8-
> > > > download-manager whilst bundled with unity8 if we can then add
> > an
> > > > additional interface once its distributed in its own snap
> > (although
> > > > I
> > > > guess that snap would have to advertise itself as providing
> > both
> > > > interfaces to keep compatibility with existing snaps). 
> > > >
> > > > I'm not sure if we gain much in this particular case though
> > since
> > > > we'd
> > > > need to be maintaining a stable API to work with existing apps
> > > > regardless?
> > > >
> > > > On Wed, 2017-01-18 at 14:24 -0200, Gustavo Niemeyer wrote:
> > > > > Sorry for not being clear. In addition to the suggestion
> > about
> > > > > ubuntu-download-manager, I also wrote this:
> > > > >
> > > > > "Note that part of the rationale of having unity8-contacts
> > and
> > > > > unity8-calendar named like that was that these interfaces are
> > > > likely
> > > > > to change in meaningful and incompatible ways in the near
> > future.
> > > > If
> > > > > the download manager is going to be bundled with unity8, it
> > may
> > > > be
> > > > > wise to do the same. We can always introduce a more general
> > > > interface
> > > > > later.. not so nice to get out of a general interface that
> > > > doesn't
> > > > > work."
> > > > >
> > > > > What's your take on it?
> > > > >
> > > > >
> > > > >
> > > > > On Wed, Jan 18, 2017 at 2:15 PM, Mike Sheldon <michael.sheldo
> > n at ca
> > > > noni
> > > > > cal.com> wrote:
> > > > > > Sorry, that was my entire point, I guess I should have
> > expanded
> > > > on
> > > > > > it a
> > > > > > bit. I agree with ubuntu-download-manager as a name, since
> > > > that's
> > > > > > the
> > > > > > name developers will be interacting with if they're using
> > our
> > > > SDK.
> > > > > > For
> > > > > > example under QML they're importing Ubuntu.DownloadManager
> > and
> > > > the
> > > > > > C++
> > > > > > namespace is Ubuntu::DownloadManager. So the interface
> > being
> > > > named
> > > > > > ubuntu-download-manager seems perfectly natural to me (in
> > fact
> > > > this
> > > > > > was
> > > > > > the initial name I proposed for it, before it was suggested
> > > > that
> > > > > > download-manager might be a better name).
> > > > > >
> > > > > > On Wed, 2017-01-18 at 13:22 -0200, Gustavo Niemeyer wrote:
> > > > > > > The second part of the point was cut out. Can you please
> > at
> > > > least
> > > > > > let
> > > > > > > us know how you feel about it, so we can be in sync about
> > the
> > > > > > right
> > > > > > > decision.
> > > > > > >
> > > > > > > On Jan 18, 2017 1:02 PM, "Mike Sheldon" <michael.sheldon@
> > cano
> > > > nica
> > > > > > l.co
> > > > > > > m> wrote:
> > > > > > > ubuntu-download-manager makes sense as a name to me,
> > > > especially
> > > > > > as
> > > > > > > it's
> > > > > > > one of the APIs in the Ubuntu SDK.
> > > > > > >
> > > > > > > On Wed, 2017-01-18 at 12:34 -0200, Gustavo Niemeyer
> > wrote:
> > > > > > > >
> > > > > > > > The real issue with download-manager is that it's too
> > > > general.
> > > > > > We
> > > > > > > all
> > > > > > > > have several download managers in our systems, so this
> > > > gives no
> > > > > > > hint
> > > > > > > > of what it's really talking about.
> > > > > > > >
> > > > > > > > We can call it ubuntu-download-manager if that's how
> > the
> > > > > > software
> > > > > > > was
> > > > > > > > named. Note that part of the rationale of having
> > unity8-
> > > > > > contacts
> > > > > > > and
> > > > > > > > unity8-calendar named like that was that these
> > interfaces
> > > > are
> > > > > > > likely
> > > > > > > > to change in meaningful and incompatible ways in the
> > near
> > > > > > future.
> > > > > > > If
> > > > > > > > the download manager is going to be bundled with
> > unity8, it
> > > > may
> > > > > > be
> > > > > > > > wise to do the same. We can always introduce a more
> > general
> > > > > > > interface
> > > > > > > > later.. not so nice to get out of a general interface
> > that
> > > > > > doesn't
> > > > > > > > work.
> > > > > > > >
> > > > > > > >
> > > > > > > >
> > > > > > > > On Wed, Jan 18, 2017 at 11:47 AM, Mike Sheldon
> > > > <michael.sheldon
> > > > > > @can
> > > > > > > on
> > > > > > > > ical.com> wrote:
> > > > > > > > > Hi all,
> > > > > > > > >
> > > > > > > > >  Currently the interface for UDM (Ubuntu Download
> > > > Manager)
> > > > > > has
> > > > > > > been
> > > > > > > > > named unity8-download-manager. It's my understanding
> > that
> > > > > > whilst
> > > > > > > we
> > > > > > > > > might initially be bundling UDM within the unity8
> > snap to
> > > > > > make
> > > > > > > the
> > > > > > > > > first stages of development easier (e.g. so it can
> > talk
> > > > > > directly
> > > > > > > to
> > > > > > > > > unity8's transfer indicator), the long term plan
> > would be
> > > > for
> > > > > > it
> > > > > > > to
> > > > > > > > > be
> > > > > > > > > available separately.
> > > > > > > > >
> > > > > > > > >  Having UDM permanently tied to unity8 would seem to
> > add
> > > > a
> > > > > > strong
> > > > > > > > > disincentive for app developers to make use of it at
> > all,
> > > > as
> > > > > > > their
> > > > > > > > > apps
> > > > > > > > > would then no-longer be portable across different
> > desktop
> > > > > > > > > environments.
> > > > > > > > >
> > > > > > > > >  As such, I'm wondering if the naming of this
> > interface
> > > > is
> > > > > > > perhaps
> > > > > > > > > misleading?
> > > > > > > > >
> > > > > > > > > Thanks,
> > > > > > > > >  Mike
> > > > > > > > >
> > > > > > > > > --
> > > > > > > > > Snapcraft mailing list
> > > > > > > > > Snapcraft at lists.snapcraft.io
> > > > > > > > > Modify settings or unsubscribe at: https://lists.ubun
> > tu.c
> > > > om/m
> > > > > > ailm
> > > > > > > an
> > > > > > > > > /listinfo/snapcraft
> > > > > > > > >
> > > > > > > >
> > > > > > > >
> > > > > > > > -- 
> > > > > > > >
> > > > > > > > gustavo @ http://niemeyer.net
> > > > > > > > -- 
> > > > > > > > Snapcraft mailing list
> > > > > > > > Snapcraft at lists.snapcraft.io
> > > > > > > > Modify settings or unsubscribe at: https://lists.ubuntu
> > .com
> > > > /mai
> > > > > > lman
> > > > > > > /l
> > > > > > > > istinfo/snapcraft
> > > > > > >
> > > > > > > --
> > > > > > > Snapcraft mailing list
> > > > > > > Snapcraft at lists.snapcraft.io
> > > > > > > Modify settings or unsubscribe at: https://lists.ubuntu.c
> > om/m
> > > > ailm
> > > > > > an/l
> > > > > > > istinfo/snapcraft
> > > > > > >
> > > > > > > -- 
> > > > > > > Snapcraft mailing list
> > > > > > > Snapcraft at lists.snapcraft.io
> > > > > > > Modify settings or unsubscribe at: https://lists.ubuntu.c
> > om/m
> > > > ailm
> > > > > > an/l
> > > > > > > istinfo/snapcraft
> > > > > >
> > > > > > --
> > > > > > Snapcraft mailing list
> > > > > > Snapcraft at lists.snapcraft.io
> > > > > > Modify settings or unsubscribe at: https://lists.ubuntu.com
> > /mai
> > > > lman
> > > > > > /listinfo/snapcraft
> > > > > >
> > > > >
> > > > >
> > > > > -- 
> > > > >
> > > > > gustavo @ http://niemeyer.net
> > > > > -- 
> > > > > Snapcraft mailing list
> > > > > Snapcraft at lists.snapcraft.io
> > > > > Modify settings or unsubscribe at: https://lists.ubuntu.com/m
> > ailm
> > > > an/l
> > > > > istinfo/snapcraft
> > > >
> > > > --
> > > > Snapcraft mailing list
> > > > Snapcraft at lists.snapcraft.io
> > > > Modify settings or unsubscribe at: https://lists.ubuntu.com/mai
> > lman
> > > > /listinfo/snapcraft
> > > >
> > >
> > >
> > > -- 
> > >
> > > gustavo @ http://niemeyer.net
> > > -- 
> > > Snapcraft mailing list
> > > Snapcraft at lists.snapcraft.io
> > > Modify settings or unsubscribe at: https://lists.ubuntu.com/mailm
> > an/l
> > > istinfo/snapcraft
> > 
> > --
> > Snapcraft mailing list
> > Snapcraft at lists.snapcraft.io
> > Modify settings or unsubscribe at: https://lists.ubuntu.com/mailman
> > /listinfo/snapcraft
> > 
> 
> 
> -- 
> 
> gustavo @ http://niemeyer.net
> -- 
> Snapcraft mailing list
> Snapcraft at lists.snapcraft.io
> Modify settings or unsubscribe at: https://lists.ubuntu.com/mailman/l
> istinfo/snapcraft