Naming for the Ubuntu Download Manager interface

[Mike Sheldon]

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