Re: RESTful Design for Internet of Things Systems -draft

Hi Michael & Victor,

Thanks for the feedback!

This is the very first version of the draft, so it is still a bit rough on
the edges and missing quite a few things we'd like to have there.
Including many of the IoT specific recommendations that still need text.

Examples of thing resources is something that I was also thinking would be
great to have, so I'll put that to the to-do list. In particular since
this document is aiming to give practical guidance, so examples should
help with that.

The servient part I'd need to think about a bit more. Victor, what did you
have in mind for that?


Cheers,
Ari

On 21/10/15 22:48, "Michael Koster" <michaeljohnkoster@gmail.com> wrote:

>It looks like there should be a description of the Forward Proxy between
>Figure 1 and Figure 2.
>
>Michael
>
>On Oct 21, 2015, at 7:32 AM, Charpenay, Victor (ext)
><victor.charpenay@siemens.com> wrote:
>
>> Hi Ari,
>> 
>> I have two remarks about your draft:
>> 
>> - the positioning of the figures in part 3.1 is not very clear. Fig. 1
>>and 2 both refer to the first paragraph but come after the second
>>paragraph (which could be maybe merged with the last paragraph, by the
>>way). 
>> 
>> - the features of REST architectures are well presented. However, most
>>of it is not specific to the IoT. It is maybe on purpose, but it is not
>>what I was expecting when I started to read the document. It might be
>>worth extending a bit the part about "servients" and its impact in the
>>system design for instance (part 3.2). Also, examples of Thing resources
>>(e.g. a sensor measurement or a parameter) or categories of Thing
>>resources would be worthwhile in part 3.3. What do you think?
>> 
>> Regards,
>> Victor
>> 
>> -----Ursprüngliche Nachricht-----
>> Von: Ari Keränen [mailto:ari.keranen@ericsson.com]
>> Gesendet: Montag, 19. Oktober 2015 23:58
>> An: Public Web of Things IG
>> Betreff: RESTful Design for Internet of Things Systems -draft
>> 
>> Hi all,
>> 
>> This new IRTF Thing-to-Thing Research Group draft might be of interest
>>to you too:
>> https://tools.ietf.org/html/draft-keranen-t2trg-rest-iot-00
>> 
>> Comments and questions are very welcome!
>> 
>> 
>> Cheers,
>> Ari
>> 
>>> Begin forwarded message:
>>> 
>>> From: Ari Keränen <ari.keranen@ericsson.com>
>>> Subject: Fwd: New Version Notification for
>>>draft-keranen-t2trg-rest-iot-00.txt
>>> Date: 20 Oct 2015 00:52:50 EEST
>>> To: "T2TRG@irtf.org" <T2TRG@irtf.org>
>>> Cc: Matthias Kovatsch <kovatsch@inf.ethz.ch>, Klaus Hartke
>>><hartke@tzi.org>
>>> 
>>> Folks,
>>> 
>>> As discussed in the Prague T2TRG meeting, we have now written a first
>>>version of a draft about guidance for designing RESTful IoT systems:
>>> https://tools.ietf.org/html/draft-keranen-t2trg-rest-iot-00
>>> 
>>> The goal of the document is to give basic and practical guidance for
>>>engineers designing such systems. There are many snippets of text from
>>>various sources and pointers for more information, all with IoT
>>>scenarios in mind.
>>> 
>>> Your comments and questions are very welcome and we look forward to
>>>discussing this in more detail at the Yokohama T2TRG sessions.
>>> 
>>> 
>>> Cheers,
>>> Ari
>>> 
>>>> Begin forwarded message:
>>>> 
>>>> From: <internet-drafts@ietf.org>
>>>> Subject: New Version Notification for
>>>>draft-keranen-t2trg-rest-iot-00.txt
>>>> Date: 19 Oct 2015 23:05:01 EEST
>>>> To: Klaus Hartke <hartke@tzi.org>, Matthias Kovatsch
>>>><kovatsch@inf.ethz.ch>, Ari Keranen <ari.keranen@ericsson.com>
>>>> 
>>>> 
>>>> A new version of I-D, draft-keranen-t2trg-rest-iot-00.txt
>>>> has been successfully submitted by Ari Keranen and posted to the
>>>> IETF repository.
>>>> 
>>>> Name:		draft-keranen-t2trg-rest-iot
>>>> Revision:	00
>>>> Title:		RESTful Design for Internet of Things Systems
>>>> Document date:	2015-10-19
>>>> Group:		Individual Submission
>>>> Pages:		13
>>>> URL:          
>>>>https://www.ietf.org/internet-drafts/draft-keranen-t2trg-rest-iot-00.tx
>>>>t
>>>> Status:       
>>>>https://datatracker.ietf.org/doc/draft-keranen-t2trg-rest-iot/
>>>> Htmlized:     
>>>>https://tools.ietf.org/html/draft-keranen-t2trg-rest-iot-00
>>>> 
>>>> 
>>>> Abstract:
>>>> This document gives guidance for designing Internet of Things (IoT)
>>>> systems that follow the principles of the Representational State
>>>> Transfer (REST) architectural style.
>>>> 
>>>> 
>>>> 
>>>> 
>>>> Please note that it may take a couple of minutes from the time of
>>>>submission
>>>> until the htmlized version and diff are available at tools.ietf.org.
>>>> 
>>>> The IETF Secretariat
>>>> 
>>> 
>> 
>

Received on Thursday, 22 October 2015 14:43:30 UTC