Naming for the Ubuntu Download Manager interface

Mon Jan 23 17:23:06 UTC 2017

That'd be ideal, thanks!

On Mon, Jan 23, 2017 at 3:19 PM, Mike Sheldon <michael.sheldon at canonical.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 canoni
> > 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.sheldon 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 at 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.ubuntu.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.com/m
> > > ailm
> > > > > an/l
> > > > > > istinfo/snapcraft
> > > > > >
> > > > > > --
> > > > > > 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
>
> --
> Snapcraft mailing list
> Snapcraft at lists.snapcraft.io
> Modify settings or unsubscribe at: https://lists.ubuntu.com/
> mailman/listinfo/snapcraft
>

-- 

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