[
Date Prev][
Date Next][
Thread Prev][
Thread Next][
Date Index][
Thread Index]
[
List Home]
Re: [hono-dev] Definition of Hono's public API
|
On 15.01.20 12:56, Dejan Bosanac wrote:
> Hi Kai,
>
> this seems reasonable to me. Just one thing, when you say "all classes",
> do you mean public methods signatures by that or something else?
>
Good point. I would say that this affects all public classes in the
"public" packages which are currently
core: all packages
client: all packages
service-base: all packages
Does that make sense?
> On Tue, Jan 14, 2020 at 8:52 AM Hudalla Kai (INST/ECS4)
> <Kai.Hudalla@xxxxxxxx <mailto:Kai.Hudalla@xxxxxxxx>> wrote:
>
> Hi list,
>
> with Hono 1.0.0 having been released last year, we now need to follow
> semantic versioning for its public API. So far so good. During the past
> weeks while implementing new features, we already ran in to situations
> where some refactoring would have been beneficial but where we had to
> think twice about whether we can simply change a method's signature or
> remove some obsolete class(es). I think we can all agree that this
> depends on whether the affected artifacts are to be considered part of
> Hono's public API or not.
>
> However, we haven't yet defined which parts of Hono actually constitute
> its public API. Thus, I would like to propose a draft of what I would
> consider (or like to see as) part of Hono's public API:
>
> 1) All remote APIs documented under [1]
> 2) All classes in the core module
> 3) All classes in the client module
> 4) All classes in the service-base module
>
> IMHO the rest would then automatically not be public API and would thus
> not be subject to semantic versioning.
>
> WDYT?
>
> [1] https://www.eclipse.org/hono/docs/api/
>
> --
> Mit freundlichen Grüßen / Best regards
>
> Kai Hudalla
>
> Software Developer - Bosch IoT Hub
>
> Bosch.IO GmbH
> Ullsteinstr. 128
> 12109 Berlin
> GERMANY
> www.bosch.io <http://www.bosch.io>
>
> Registered Office: Berlin, Registration Court: Amtsgericht
> Charlottenburg; HRB 148411 B
> Chairman of the Supervisory Board: Dr.-Ing. Thorsten Lücke;
> Managing Directors: Dr. Stefan Ferber, Dr. Aleksandar Mitrovic, Yvonne
> Reckling
> _______________________________________________
> hono-dev mailing list
> hono-dev@xxxxxxxxxxx <mailto:hono-dev@xxxxxxxxxxx>
> To change your delivery options, retrieve your password, or
> unsubscribe from this list, visit
> https://www.eclipse.org/mailman/listinfo/hono-dev
>
>
>
> --
> Regards
> --
> Dejan Bosanac
> http://sensatic.net/about
>
> _______________________________________________
> hono-dev mailing list
> hono-dev@xxxxxxxxxxx
> To change your delivery options, retrieve your password, or unsubscribe from this list, visit
> https://www.eclipse.org/mailman/listinfo/hono-dev
>
--
Mit freundlichen Grüßen / Best regards
Kai Hudalla
Software Developer - Bosch IoT Hub
Bosch.IO GmbH
Ullsteinstr. 128
12109 Berlin
GERMANY
www.bosch.io
Registered Office: Berlin, Registration Court: Amtsgericht
Charlottenburg; HRB 148411 B
Chairman of the Supervisory Board: Dr.-Ing. Thorsten Lücke;
Managing Directors: Dr. Stefan Ferber, Dr. Aleksandar Mitrovic, Yvonne
Reckling