I think it looks good, and I'm very pleased to see the project
graduate. +1
On 20/09/2018 00:55, Woodard, David
wrote:
Hello PMC team,
It seems this is a little stuck. Maybe we
can get some closure on this soon? I have recapped below:
Kai H – Initial questions that have been
addressed by Stefano. Waiting to hear if these changes are
acceptable. Maybe Kai H is on holiday?
Kai K - +1
Jens – Initial questions that have been
addressed by Stefano. Jens, are you abstaining from voting due
to your involvement? Did Stefano adequately answer your
questions?
Benjamin – No vote/comments
David - +1
Thanks,
--Dave
+1 for me as well, great work!
Congratulations to the entire Kapua team!
--Dave
Hi Kai,
thanks for your
feedback.
Regarding the user
doc we'll work to improve it.
For the swagger
point, having it integrated in the doc (as you did)
through the generated json file looks a good idea so
we'll check how we can adapt this approach for Kapua
docs as well.
Hi Stefano,
Documentation
is reachable from the project home in github repo:
Documentation of
the Rest APIs is part of the application and
provided through swagger.
So
if the REST API is the major user documentation,
it would indeed be nice to have it available on
the website. Note that in Eclipse SmartHome we are
also using Swagger and we simply publish the
generated json to our static website, which can
nicely render the docs there: https://www.eclipse.org/smarthome/rest/index.html
I’d
suggest you look into doing it a similar way for
Kapua as well. I’d be ok with adding that in
future, so it is not a blocker for me for the 1.0
release.
So
from my side a +1 and congrats on the graduation!
Documentation is
reachable from the project home in github
repo:
Documentation
of the Rest APIs is part of the application and
provided through swagger. The easiest way to
have it available is by starting a Kapua
instance (attached there are a couple
of screenshots). The same documentation can be
made available as an
automatically generated swagger.json file that
can be uploaded in a swagger reader.
On Fri,
2018-08-31 at 10:22 +0000, Morson, Stefano
wrote:
> Hi all,
>
> just wanted to check if there's any
feedback on the documentation provided or
> any other feedback/open-point regarding
the upcoming review request.
>
Is there a way to take a look at the
documentation that will be published with
1.0?
> Regards,
> Stefano
>
> From: iot-pmc-bounces@xxxxxxxxxxx
<iot-pmc-bounces@xxxxxxxxxxx>
on behalf of
> Morson, Stefano <stefano.morson@xxxxxxxxxxxx>
> Sent: Wednesday, August 22, 2018 11:58:29
AM
> To: PMC list for IoT top level project
> Subject: Re: [iot-pmc] Eclipse Kapua 1.0
Release Review
>
> Hi Jens,
>
> I just updated the release review
documentation [1 ]including more informations
> regarding the topics that you pointed
out.
>
> Hope that this new version amends the
lack of details of the previous one, if
> any further information is required
please let me know.
>
> [1] https://projects.eclipse.org/projects/iot.kapua/releases/1.0.0/review
>
> Cheers,
> Stefano
> From: iot-pmc-bounces@xxxxxxxxxxx
<iot-pmc-bounces@xxxxxxxxxxx>
on behalf of
> Jens Reimann <jreimann@xxxxxxxxxx>
> Sent: Friday, August 17, 2018 8:55:33 AM
> To: PMC list for IoT top level project
> Subject: Re: [iot-pmc] Eclipse Kapua 1.0
Release Review
>
> Hi Stefano,
>
> I just checked the release review
documentation, regarding the graduation
> review. The project handbook says:
>
> ---
>
> For a graduation review, release review
documentation must be augmented to
> include demonstration of:
> * solid working code with stable APIs;
> * an established and growing community
around the project;
> * diverse multi-organization
committer/contributor/developer activity; and
> * operation in the open using open
source rules of engagement.
> ---
>
> So I think #1 is fine. And so would be
the release of 1.0.0 version for me.
>
> What I am missing in the review
documentation is a demonstration of the three
> other items. Maybe you could amend that
to make it more transparent to
> everyone.
>
> Cheers
>
> Jens
>
> On Thu, Aug 16, 2018 at 3:37 PM, Morson,
Stefano <stefano.morson@xxxxxxxxxxxx>
> wrote:
> > Hi,
> >
> >
> > as part of the release review for
Kapua 1.0, planned for September 5th, we
> > need the approval by PMCs for the
release review documentation in [1].
> >
> > Note. As stated in the review
documentation (description section) with this
> > release we would like to graduate
the Eclipse Kapua project.
> >
> > [1] - https://projects.eclipse.org/projects/iot.kapua/releases/1.0.0/review
> >
> >
> > Stefano Morson
> > Senior Software Manager
> > Eurotech Spa
> >
> >
_______________________________________________
> > iot-pmc mailing list
> > iot-pmc@xxxxxxxxxxx
> > To change your delivery options,
retrieve your password, or unsubscribe from
> > this list, visit
> > https://dev.eclipse.org/mailman/listinfo/iot-pmc
> >
>
>
>
>
_______________________________________________
> iot-pmc mailing list
> iot-pmc@xxxxxxxxxxx
> To change your delivery options, retrieve
your password, or unsubscribe from
> this list, visit
> https://dev.eclipse.org/mailman/listinfo/iot-pmc
_______________________________________________
iot-pmc mailing list
iot-pmc@xxxxxxxxxxx
To change your delivery options, retrieve your
password, or unsubscribe from this list, visit
https://dev.eclipse.org/mailman/listinfo/iot-pmc
<Kapua_1.0_api_home.png><Kapua_1.0_api_auth.png>_______________________________________________
iot-pmc mailing list
iot-pmc@xxxxxxxxxxx
To change your delivery options, retrieve your
password, or unsubscribe from this list, visit
https://dev.eclipse.org/mailman/listinfo/iot-pmc
_______________________________________________
iot-pmc mailing list
iot-pmc@xxxxxxxxxxx
To change your delivery options, retrieve your password, or unsubscribe from this list, visit
https://dev.eclipse.org/mailman/listinfo/iot-pmc
--
Ian Craggs
icraggs@xxxxxxxxxx IBM United Kingdom
Eclipse Paho Project Lead & Mosquitto Committer
|