Naming for the Ubuntu Download Manager interface

Mon Jan 23 16:34:18 UTC 2017

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 canonical.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.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
>
> --
> Snapcraft mailing list
> Snapcraft at lists.snapcraft.io
> Modify settings or unsubscribe at: https://lists.ubuntu.com/mailm
> an/listinfo/snapcraft
>

-- 

gustavo @ http://niemeyer.net
-------------- next part --------------
An HTML attachment was scrubbed...
URL: <https://lists.ubuntu.com/archives/snapcraft/attachments/20170123/a197841b/attachment.html>