Naming for the Ubuntu Download Manager interface

Mike Sheldon michael.sheldon at canonical.com
Wed Jan 18 16:34:38 UTC 2017


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.sheldon at canoni
> 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 at canonica
> > 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.ubuntu.com/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.com/mailm
> > an/l
> > > istinfo/snapcraft
> > >
> > > -- 
> > > 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




More information about the Snapcraft mailing list