Skip to content

Commit 129ff81

Browse files
JKRhbcabo
andauthored
Apply suggestions from code review
Co-authored-by: cabo <cabo@tzi.org> Co-authored-by: Jan Romann <jan.romann@uni-bremen.de>
1 parent a7fe915 commit 129ff81

1 file changed

Lines changed: 4 additions & 4 deletions

File tree

draft-ietf-asdf-instance-information.md

Lines changed: 4 additions & 4 deletions
Original file line numberDiff line numberDiff line change
@@ -765,14 +765,14 @@ title="Example of an SDF Snapshot Messages that reports an action and an event h
765765

766766
# Discussion
767767

768-
Instance-related messages close an important semantic gap of SDF, which so far was only capable of describing device classes and their capabilities.
768+
Instance-related messages close an important semantic gap of SDF, which so far was only capable of describing device classes and their capabilities, leaving the exercise of affordances to the ecosystem-specific mechanisms.
769769
There are, however, a few aspects that need special consideration and have to be addressed by more fine-grained specifications in the future that will buid upon this one.
770770

771-
Instance-related messages allow for the setting of timestamps that currently relate to the message as a whole.
771+
Instance-related messages allow for noting down timestamps that currently relate to the message as a whole.
772772
Since the values contained within an instance-related message might reflect state updates such as measurements that occurred before composing the message, this timestamp cannot accurately reflect the device state at that exact moment.
773773
In this sense, instance-related messages really are imperfect "proofshots" when it comes to the state of affordances, also considering that there might be concurrency problems if a device is updated while generating a Snapshot or Delta message.
774774

775-
With IoT devices, many additional potential time-related problems arise, as devices might have access to (credible) time information {{-raytime}} or can only measure time unreliably due to resource constraints, accuracy problems, and/or their sleeping behavior {{Section 4.4 of -terms}}.
775+
With IoT devices, many additional potential time-related problems arise, as devices might have access to (credible) time information {{-raytime}} or can only measure time unreliably due to resource constraints, accuracy problems, and/or their sleeping behavior ({{Section 4.4 of -terms}}).
776776
In cases like these, timestamps might have to be omitted from instance-related messages or need to be estimated by a more reliable intermediary.
777777

778778
<!-- TODO: these are still open: -->
@@ -785,7 +785,7 @@ Discuss using context information to indicate provence
785785

786786
The security considerations of {{-sdf}} apply to this document as well.
787787

788-
Entities processing instance-related messages need to take measures to ensure the provenance of instance-related messages, including authenticity and integraty.
788+
Entities processing instance-related messages need to take measures to ensure the provenance of instance-related messages, including authenticity and integrity.
789789
For this purpose, they may use the context and state information contained within a given message.
790790

791791
Instance-related information may might only be available in certain scopes, e.g. when it comes to security-related configuration parameters.

0 commit comments

Comments
 (0)